Developer CD Series 1999 May: Tool Chest

home *** CD-ROM | disk | FTP | other *** search

/ Developer CD Series 1999 May: Tool Chest / Developer CD Series Tool Chest (Apple Computer)(May 1999).iso / Tool Chest / Development Kits / MPW etc / MPW-PR / MPW / MPW.Help < prev next >

Wrap

Text File | 1998-12-16 | 226.1 KB | 4,207 lines | [TEXT/MPS ]

MPW Help Summaries -- Pre-release Copyright Apple Computer, Inc. 1986-1998 All rights reserved. Help summaries are available for each of the MPW commands. To see the list of all commands enter "Help Commands". To see a partial list of commands, e.g., those relating to compilers, enter "Help Languages". Some commands may appear in more than one category. In addition, brief descriptions of Expressions, Patterns, Selections, Characters, Shortcuts, and Variables are also included. To see Help summaries, enter a command such as Help Commands # a list of all commands Help Editing # a list of commands useful for editing Help FileSystem # a list of commands relating to files, directories, and volumes Help Languages # a list of compiler/assembler names Help Miscellaneous # a list of commands useful for software development Help Projector # a list of commands in Projector, a project/source control system Help Resources # a list of commands useful in processing resources Help Scripting # a list of commands useful primarily within scripts Help System # a list of commands that perform system functions Help Window # a list of commands pertaining to windows Help CFM-68K # a list of commands useful for CFM-68K development Help PowerMacintosh # a list of commands useful for Power Macintosh development Help Launch # information on launching applications from the Shell Help Variables # summary of the standard MPW shell variables Help Characters # summary of MPW Shell special characters Help Expressions # summary of expressions Help Selections # summary of selections Help Patterns # summary of patterns (regular expressions) Help Shortcuts # summary of MPW Shell shortcuts - Commands This is a full alphabetic list of all commands in MPW. This includes built-in commands, commands that are implemented as scripts, and commands that are implemented as tools. To get details, enter a command such as Help AddMenu # add a menu item Help AddPane # split the window into panes Help Adjust # adjust lines Help Alert # display an alert box Help Alias # define or write command aliases Help Align # align text to left margin Help Asm # MC68xxx Macro Assembler Help ATags # create a tag file based on Asm source code Help AuthorInfo # print information about the authors in a project Help Backup # folder file backup Help Beep # generate tones Help Begin # group commands Help Break # break from For or Loop Help Browser # invoke Marker Browser Help BuildCommands # show build commands Help BuildMenu # create the Build menu Help BuildProgram # build the specified program Help Canon # canonical spelling tool Help Catenate # concatenate files Help CheckIn # check a file into a project Help CheckOut # check a file out from a project Help CheckOutDir # specify the directory where checked out files will be placed Help Choose # choose or list network file server volumes and printers Help Clear # clear the selection Help Close # close specified windows Help CMarker # generate Mark commands for C and C++ function definitions Help Commando # present a dialog interface for commands Help Compare # compare text files Help CompareFiles # compare text files and interactively view differences Help CompareRevisions # compare two revisions of a file in a project Help Confirm # display a confirmation dialog box Help Continue # continue with next iteration of For or Loop Help Copy # copy selection to Clipboard Help Count # count lines and characters Help CreateMake # create a simple makefile Help CTags # create a tag file based on C source code Help Cut # copy selection to Clipboard and delete it Help Date # write the date and time Help Delete # delete files and directories Help DeleteMenu # delete user-defined menus and menu items Help DeleteNames # delete user-defined symbolic names Help DeletePane # delete panes from the window Help DeleteRevisions # delete previous revisions of files in a project Help DeRez # resource decompiler Help Directory # set or write the default directory Help DirectoryMenu # create the Directory menu Help DoIt # highlight and execute a series of shell commands Help DumpCode # write formatted CODE resources Help DumpFile # display contents of any file Help DumpObj # write formatted object file Help DumpPEF # dump formatted PEF file Help DumpSYM # dump formatted SYM or xSYM file Help DumpXCOFF # write formatted XCOFF file Help Duplicate # duplicate files and directories Help DuplicateNameRevisions # duplicate symbolic names Help Echo # echo parameters Help Eject # eject volumes Help Entab # convert runs of spaces to tabs Help Equal # compare files and directories Help Erase # initialize volumes Help Evaluate # evaluate an expression Help Execute # execute command file in the current scope Help Exists # confirm the existence of a file or directory Help Exit # exit from a command file Help Export # make variables available to commands Help FileDiv # divide a file into several smaller files Help Files # list files and directories Help Find # find and select a text pattern Help FindTag # output data associated with tag Help Flush # flush the tools that the Shell has cached Help FlushAllVolumes # write cached File Manager data structures to disk Help For # repeat commands once per parameter Help Format # set or display formatting options for a window Help Gestalt # output information about the operating environment Help Get # get a record from an indexed file Help GetErrorText # display error messages based on message number Help GetFileName # display a Standard File dialog box Help GetListItem # display items for selection in a dialog box Help Help # write summary information Help HideWindows # hide specified windows Help If # conditional command execution Help ILink # incrementally link an application, tool, shared library or resource Help ILinkToSYM # generate .SYM file from ILink state file Help Lib # combine object files into a library file Help Line # find line in the target window Help Link # link an application, tool, or resource Help LockNameRevisions # lock a symbolic name Help Loop # repeat commands until Break Help Make # build up-to-date version of a program Help MakeDepend # generate makefile dependencies for "include" files Help MakeErrorFile # create error message textfile Help MakeFlat # flatten a segmented shared library created by ILink Help MakePEF # XCOFF to PEF converter Help MakePPCCodeRsrc # create a PowerPC code resource from a PEF file Help MakeStub # create a PowerPC, CFM-68K or fat stub library Help MakeSYM # extract SYM information from XCOFF Help Mark # assign a marker to a selection Help Markers # list markers Help MatchIt # semi-intelligent language sensitive bracket matcher Help MergeBranch # merge a branch revision onto the trunk Help MergeFragment # merge code fragments Help ModifyReadOnly # enables a read-only Projector file to be edited Help ModPEF # extract, delete and/or modify PEF fragments Help Monitors # list monitor rectangle(s) Help Mount # mount volumes Help MountProject # mount projects Help Move # move files and directories Help MoveWindow # move window to h,v location Help MrC # C Compiler for Macintosh On RISC Help MrCpp # C++ Compiler for Macintosh On RISC Help MrPlus # Post-link analysis of a Macintosh PowerPC™ executable for code # coverage or performance Help MultiSearch # find multiple patterns in text files in a directory tree Help NameRevisions # define a symbolic name Help New # open a new window Help Newer # compare modification dates of files Help NewFolder # create a new folder Help NewKeyMap # create alternate keyboard editor assignments Help NewProject # create a new project Help ObsoleteNameRevisions # mark a symbolic name obsolete Help ObsoleteProjectorFile # make a Projector file inactive Help Open # open file(s) in window(s) Help OrphanFiles # remove Projector information from a list of files Help Parameters # write parameters Help Pascal # Pascal compiler Help PasMat # Pascal programs formatter Help PasRef # Pascal cross-referencer Help Paste # replace selection with Clipboard contents Help PerformReport # generate a performance report Help PlaySound # play a sound ('snd ') resource Help PopTag # fetch top of FindTag stack Help Position # display current line position Help PPCAsm # PowerPC™ 60x Assembler Help PPCLink # link a PowerPC application, tool, shared library or static library Help PPCProff # analyze a .pgh file and display the results Help Print # print text files Help PrintProff # analyze a .proff file and print the results Help ProcNames # display Pascal procedure and function names Help Project # set or write the current project Help ProjectInfo # display information about a Project Help Quit # quit MPW Help Quote # echo parameters, quoting if needed Help Redo # reverse previous Undo series (if {AllowMultipleUndo} = 1) Help Rename # rename files and directories Help RenameProjectorFile # give Projector file a new name Help Replace # replace the selection Help Request # request text from a dialog box Help ResEqual # compares the resources in two files Help ResolveAlias # resolve aliases in pathname Help Revert # revert window to previous saved state Help Rez # resource compiler Help RezDet # detect inconsistencies in resources Help RotatePanes # make another window pane the active pane Help RotateWindows # send active (frontmost) window to back Help RProj # send Projector command to SourceServer Help RShell # send a command to a "remote" shell Help Save # save specified windows Help SaveOnClose # set save behavior when closing windows Help SC # Symantec C compiler Help SCpp # Symantec C++ compiler Help SCPre # Symantec C/C++ preprocessor Help Search # search files for pattern Help SendAE # Send Apple Event to application Help Set # define or write Shell variables Help SetDirectory # set the default directory Help SetFile # set file attributes Help SetKey # define or write key bindings Help SetPrivilege # set access privileges for directories on file servers Help SetShellSize # set the shell's stack and Process Manager partition sizes Help SetVersion # maintain version and revision number Help Shift # renumber command file positional parameters Help shlb2stub # create a stub ('stub') library from a shared ('shlb') library Help ShowSelection # place the selection within an editor window Help ShowWindows # make previous hidden windows visible Help Shutdown # power down or restart the machine Help SizeWindow # set a window's size Help SOMC # SOM idl compiler Help SOMpdl # sanitize .idl file(s) for public consumption Help Sort # sort or merge lines of text Help StackWindows # arrange windows diagonally Help StreamEdit # scriptable text editor Help Target # make a window the target window Help TickCount # returns current system Tick Count Help TileWindows # arrange windows in a tiled fashion Help TransferCkid # move Projector information from one file to another Help Translate # translate characters Help Unalias # remove aliases Help Undo # undo the last edit (or edits if {AllowMultipleUndo} = 1) Help Unexport # remove variable definitions from the export list Help UnlockNameRevisions # unlock a symbolic name Help Unmangle # unmangle mangled C++ names Help Unmark # remove a marker from a window Help Unmount # unmount volumes Help UnmountProject # unmount projects Help UnobsoleteNameRevisions # mark a symbolic name not obsolete Help UnObsoleteProjectorFile # make an inactive Projector file active again Help Unset # remove Shell variable definitions Help UnsetKey # remove key bindings Help UpdateProjectorDatabase # update Projector database to latest version Help UserVariables # uses Commando to set all the user variables Help Version # print the version of the MPW Shell Help VersionList # print version info from files Help Volumes # list mounted volumes Help WhereIs # find the location of a file Help Which # determine which file the shell will execute Help Windows # list windows Help ZoomWindow # enlarge or reduce a window's size - Editing The commands in this list are primarily useful for the editing of files. To get details, enter a command such as Help Adjust # adjust lines Help Align # align text to left margin Help ATags # create a tag file based on Asm source code Help Canon # canonical spelling tool Help Clear # clear the selection Help CompareFiles # compare text files and interactively view differences Help Copy # copy selection to Clipboard Help CTags # create a tag file based on C source code Help Cut # copy selection to Clipboard and delete it Help Entab # convert runs of spaces to tabs Help FileDiv # divide a file into several smaller files Help Find # find and select a text pattern Help FindTag # output data associated with tag Help Format # set or display formatting options for a window Help Line # find line in the target window Help Mark # assign a marker to a selection Help Markers # list markers Help MatchIt # semi-intelligent language sensitive bracket matcher Help NewKeyMap # create alternate keyboard editor assignments Help Paste # replace selection with Clipboard contents Help Redo # reverse previous Undo series (if {AllowMultipleUndo} = 1) Help Replace # replace the selection Help ShowSelection # place the selection within an editor window Help SetKey # define or write key bindings Help StreamEdit # scriptable text editor Help Translate # translate characters Help Undo # undo the last edit (or edits if {AllowMultipleUndo} = 1) Help Unmark # remove a marker from a window Help UnsetKey # remove key bindings - FileSystem The commands in this list relate to the manipulation of files and volumes. To get details, enter a command such as Help Catenate # concatenate files Help Close # close specified windows Help Compare # compare text files Help CompareFiles # compare text files and interactively view differences Help Count # count lines and characters Help Delete # delete files and directories Help Directory # set or write the default directory Help DumpFile # display contents of any file Help Duplicate # duplicate files and directories Help Equal # compare files and directories Help Erase # initialize volumes Help Exists # confirm the existence of a file or directory Help FileDiv # divide a file into several smaller files Help Files # list files and directories Help Move # move files and directories Help Mount # mount volumes Help MultiSearch # find multiple patterns in text files in a directory tree Help New # open a new window Help Newer # compare modification dates of files Help NewFolder # create a new folder Help Open # open file(s) in window(s) Help Position # display current line position Help Print # print text files Help Rename # rename files and directories Help ResolveAlias # resolve aliases in pathname Help Save # save specified windows Help Search # search files for pattern Help SetDirectory # set the default directory Help SetFile # set file attributes Help SetPrivilege # set access privileges for directories on file servers Help SetVersion # maintain version and revision number Help Target # make a window the target window Help Unmount # unmount volumes Help Volumes # list mounted volumes Help WhereIs # find the location of a file - Languages The commands in this group relate to various language processors. To get details, enter a command such as Help Asm # MC68xxx Macro Assembler Help MrC # C Compiler for Macintosh On RISC Help MrCpp # C++ Compiler for Macintosh On RISC Help Pascal # Pascal compiler Help PPCAsm # PowerPC 60x Assembler Help SC # Symantec C compiler Help SCpp # Symantec C++ compiler Help SCPre # Symantec C/C++ preprocessor Help SOMC # SOM idl compiler Help SOMpdl # sanitize .idl file(s) for public consumption - Miscellaneous The following commands are a conglomeration of miscellaneous utilities and tools that are of use in the software construction process. To get details, enter a command such as Help Backup # folder file backup Help BuildCommands # show build commands Help BuildMenu # create the Build menu Help BuildProgram # build the specified program Help CMarker # generate Mark commands for C and C++ function definitions Help Commando # present a dialog interface for commands Help CreateMake # create a simple makefile Help DeRez # resource decompiler Help DumpCode # write formatted CODE resources Help DumpObj # write formatted object file Help DumpPEF # dump formatted PEF file Help DumpSYM # dump formatted SYM or xSYM file Help DumpXCOFF # write formatted XCOFF file Help ILink # incrementally link an application, tool, shared library or resource Help ILinkToSYM # generate .SYM file from ILink state file Help Lib # combine object files into a library file Help Link # link an application, tool, or resource Help Make # build up-to-date version of a program Help MakeDepend # generate makefile dependencies for "include" files Help MakeErrorFile # create error message textfile Help MakeFlat # flatten a segmented shared library created by ILink Help MakePPCCodeRsrc # create a PowerPC code resource from a PEF file Help MakeStub # create a PowerPC, CFM-68K or fat stub library Help ModPEF # extract, delete and/or modify PEF fragments Help PerformReport # generate a performance report Help PPCLink # link a PowerPC application, tool, shared library or static library Help PPCProff # analyze a .pgh file and display the results Help ProcNames # display Pascal procedure and function names Help Rez # resource compiler Help RezDet # detect inconsistencies in resources Help SetVersion # maintain version and revision number Help shlb2stub # create a stub ('stub') library from a shared ('shlb') library Help Sort # sort or merge lines of text Help VersionList # print version info from files - Projector Projector is a collection of built-in MPW commands and windows that help programmers (both individuals and teams) control and account for changes to all the files (documentation, source, applications etc.) associated with a software project. Here is a brief summary of the commands (the CheckIn, CheckOut, and NewProject commands also have windows that can be opened using the “-w” option to the respective command). For help, enter a command such as Help AuthorInfo # print information about the authors in a project Help CheckIn # check a file into a project Help CheckOut # check a file out from a project Help CheckOutDir # specify the directory where checked out files will be placed Help CompareRevisions # compare two revisions of a file in a project Help DeleteNames # delete user-defined symbolic names Help DeleteRevisions # delete previous revisions of files in a project Help DuplicateNameRevisions # duplicate symbolic names Help LockNameRevisions # lock a symbolic name Help MergeBranch # merge a branch revision onto the trunk Help ModifyReadOnly # enables a read-only Projector file to be edited Help MountProject # mount projects Help NameRevisions # define a symbolic name Help NewProject # create a new project Help ObsoleteNameRevisions # mark a symbolic name obsolete Help ObsoleteProjectorFile # make a Projector file inactive Help OrphanFiles # remove Projector information from a list of files Help Project # set or write the current project Help ProjectInfo # display information about a Project Help RenameProjectorFile # give Projector file a new name Help RProj # send Projector command to SourceServer Help TransferCkid # move Projector information from one file to another Help UnlockNameRevisions # unlock a symbolic name Help UnmountProject # unmount projects Help UnobsoleteNameRevisions # mark a symbolic name not obsolete Help UnObsoleteProjectorFile # make an inactive Projector file active again Help UpdateProjectorDatabase # update Projector database to latest version - Resources The following commands are used to process resources. For details, enter a command such as Help DeRez # resource decompiler Help ResEqual # compares the resources in two files Help Rez # resource compiler Help RezDet # detect inconsistencies in resources - Scripting The commands in this list are particularly useful within scripts. To get details, enter a command such as Help AddMenu # add a menu item Help Alert # display an alert box Help Alias # define or write command aliases Help Beep # generate tones Help Begin # group commands Help Break # break from For or Loop Help Confirm # display a confirmation dialog box Help Continue # continue with next iteration of For or Loop Help Date # write the date and time Help DeleteMenu # delete user-defined menus and menu items Help DirectoryMenu # create the Directory menu Help DoIt # highlight and execute a series of shell commands Help Echo # echo parameters Help Evaluate # evaluate an expression Help Execute # execute command file in the current scope Help Exists # confirm the existence of a file or directory Help Exit # exit from a command file Help Export # make variables available to commands Help For # repeat commands once per parameter Help GetFileName # display a Standard File dialog box Help GetListItem # display items for selection in a dialog box Help If # conditional command execution Help Loop # repeat commands until Break Help Parameters # write parameters Help PlaySound # play a sound ('snd ') resource Help Quote # echo parameters, quoting if needed Help Request # request text from a dialog box Help ResolveAlias # resolve aliases in pathname Help RShell # send a command to a "remote" shell Help Set # define or write Shell variables Help Shift # renumber command file positional parameters Help Unexport # remove variable definitions from the export list Help Unset # remove Shell variable definitions - System The following commands provide direct access from MPW to certain system functions. For help, enter a command such as Help Choose # choose or list network file server volumes and printers Help Date # write the date and time Help Gestalt # output information about the operating environment Help GetErrorText # display error messages based on message number Help SetPrivilege # set access privileges for directories on file servers Help Shutdown # power down or restart the machine Help TickCount # returns current system Tick Count - Window The following commands are used to manipulate windows. For details, enter a command such as Help AddPane # split the window into panes Help Close # close specified windows Help DeletePane # delete panes from the window Help Format # set or display formatting options for a window Help HideWindows # hide specified windows Help MoveWindow # move window to h,v location Help New # open a new window Help Open # open file(s) in window(s) Help RotatePanes # make another window pane the active pane Help RotateWindows # send active (frontmost) window to back Help Save # save specified windows Help SaveOnClose # set save behavior when closing windows Help ShowSelection # place the selection within an editor window Help ShowWindows # make previous hidden windows visible Help SizeWindow # set a window's size Help StackWindows # arrange windows diagonally Help Target # make a window the target window Help TileWindows # arrange windows in a tiled fashion Help Windows # list windows Help ZoomWindow # enlarge or reduce a window's size - CFM-68K The following commands are used for CFM-68K development. For details, enter a command such as Help Asm # MC68xxx Macro Assembler Help DumpCode # write formatted CODE resources Help DumpObj # write formatted object file Help DumpPEF # dump formatted PEF file Help DumpSYM # dump formatted SYM or xSYM file Help ILink # incrementally link an application, tool, shared library or resource Help ILinkToSYM # generate .SYM file from ILink state file Help Lib # combine object files into a library file Help MakeFlat # flatten a segmented shared library created by ILink Help MakeStub # create a PowerPC, CFM-68K or fat stub library Help MergeFragment # merge code fragments Help ModPEF # extract, delete and/or modify PEF fragments Help SC # Symantec C compiler Help SCpp # Symantec C++ compiler Help shlb2stub # create a stub ('stub') library from a shared ('shlb') library - PowerMacintosh The following commands are used for Power Macintosh development. For details, enter a command such as Help DumpPEF # dump formatted PEF file Help DumpXCOFF # write formatted XCOFF file Help MakePEF # XCOFF to PEF converter Help MakePPCCodeRsrc # create a PowerPC code resource from a PEF file Help MakeStub # create a PowerPC, CFM-68K or fat stub library Help MakeSYM # extract SYM information from XCOFF Help MergeFragment # merge code fragments Help ModPEF # extract, delete and/or modify PEF fragments Help MrC # C Compiler for Macintosh On RISC Help MrCpp # C++ Compiler for Macintosh On RISC Help MrPlus # Post-link analysis of a Macintosh PowerPC™ executable for code # coverage or performance Help PPCAsm # PowerPC 60x Assembler Help PPCLink # link a PowerPC application, tool, shared library or static library Help PPCProff # analyze a .pgh file and display the results Help shlb2stub # create a stub ('stub') library from a shared ('shlb') library - Launch The command line used by MPW to launch an application consists of the name or path of the application and, optionally, a list of files and command line options. A command line consisting of an application name will cause the application to be launched in the foreground. If the application is already running, it will be brought to the foreground. Any files listed on the command line will be opened by the application if it is capable of opening them. If the command line option -print is specified, the files will be printed instead of opened and the application will quit when it has finished printing the documents (unless it was already running). (In previous versions of MPW, this option was -p.) The following options are recognized: -print # print any files listed on the command line. -background # launch the application in the background -quit # cause a running application to quit -wait # delay resumption of Shell commands until the # application has quit - Variables To see the current value, enter a command such as Echo {<var name>} Variables defined by the MPW Shell: Echo {Active} # full pathname of current active window Echo {Aliases} # list of all defined aliases Echo {Boot} # volume name of the boot disk Echo {Command} # full pathname of the last command executed Echo {MPW} # full pathname of the Macintosh Programmer's Workshop. Echo {ShellDirectory} # full pathname of the directory that contains the MPW Shell Echo {Status} # result of the last command executed (0 means successful) Echo {SystemFolder} # full pathname of the system folder Echo {Target} # full pathname of the target window Echo {User} # the current user name (initialized to the “Chooser” name) Echo {Windows} # list of current windows Echo {Worksheet} # full pathname of the Worksheet window Variables used by the MPW Shell: Echo {AllowCmdsOnlyInWorkSheet} # control behavior of "Enter" key in non-Worksheet windows Echo {AllowColorizing} # provide color coding of syntax categories Echo {AllowColorUserExperience} # control platinum appearance Echo {AllowDraggingOut} # provide drag and drop Echo {AllowForeignFileSupport} # provide dos and unix file support Echo {AllowMultipleUndo} # provide stacked multiple undo and redo Echo {AllowWhiteSpaceDelimiter} # provide double clicking on space and tab characters Echo {AutoIndent} # auto indent setting used for new windows Echo {CaseSensitive} # control case sensitivity for searching Echo {Commando} # name of the commando tool Echo {Commands} # list of directories to search for commands Echo {CursorForDragging} # set cursor used while dragging Echo {DirectoryPath} # list of common directories to speed changing directories Echo {DynaScroll} # control dynamic scrolling in windows Echo {Echo} # control the echoing of commands to diagnostic output Echo {Exit} # control script termination based on {Status} Echo {ExtendWordSet} # control behavior of cursor movement across word boundaries Echo {Font} # font used for new windows Echo {FontSize} # font size used for new windows Echo {HeapCheck} # control heap checking before and after tool call Echo {HideHelpKey} # deactivate "help" key on extended keyboard Echo {IgnoreCmdPeriod} # control use of cmd-. during critical sections Echo {InhibitMarkCopy} # control whether Marks are copied with the Edit:Copy menu command Echo {NewKeyboardLayout}# control keyboard layout Echo {NewWindowRect} # window rectangle used for new windows (top, left, bottom, right) Echo {PrefsFolder} # contains path to location to be searched first for # startup, quit, worksheet, etc. files Echo {PrintOptions} # options used by the print menu commands Echo {ScreenUpdateDelay} # control frequency of status box and cursor update Echo {SearchBackward} # control direction of searching Echo {SearchType} # control type of searching (literal/word/expression) Echo {SearchWrap} # control wrap-around search Echo {StackOptions} # options used by the Stack Windows menu command Echo {SysTempFolder} # contains path to system-defined location for temporary storage Echo {Tab} # tab size used for new windows Echo {TempFolder} # contains path to location to be used for temporary storage Echo {Test} # control execution of tools and applications Echo {TileOptions} # options used by the Tile Windows menu command Echo {ToolSleepTime} # value is passed to WaitNextEvent while command is running Echo {TraceFailures} # control sending of diagnostic message on abnormal # termination of script Echo {UseStandardFile} # use Standard File vs. Navigation Services dialogs Echo {WordSet} # set of characters that constitute a word Echo {ZoomHeight} # height to which window is to zoom (ZoomWindowRect not set) Echo {ZoomWidth} # width to which window is to zoom (ZoomWindowRect not set) Echo {ZoomWindowRect} # window rectangle used for a zoomed window (top, left, bottom, right) Variables automatically set before script execution: {0} name of the currently executing script {1}, {2}, … {n} first, second, and nth parameter to the script {#} number of parameters {Parameters} equivalent to {1} {2} … {n} {"Parameters"} equivalent to "{1}" "{2}" … "{n}" Variables used for libraries and include files: Echo {AIncludes} # directories to search for assembly-language include files Echo {CFM68KLibraries} # directory containing CFM-68K runtime library files Echo {CIncludes} # directories to search for C include files Echo {CLibraries} # directory containing C library files Echo {Libraries} # directory containing Classic 68K runtime library files Echo {PInterfaces} # directory containing Pascal interface files Echo {PPCLibraries} # directory containing PowerPC library files Echo {PLibraries} # directory containing Pascal library files Echo {RIncludes} # directory containing Rez include files Echo {SharedLibraries} # directory containing shared library files Echo {SMIncludes} # standard path for .idl include files Echo {SMDefines} # standard defines for somc Echo {SMOptions} # standard options - Characters The characters listed below have special meanings in the command language. Space Space separates words. Tab Tab also separates words. Return Return separates commands. ; Semicolon also separates commands. | Pipe separates commands and pipes output to input. && And separates commands, executing second if first succeeds. || Or separates commands, executing second if first fails. (…) Parenthesis group commands. Parenthesis also group characters in filename patterns. # Comment begins comments. ∂ Escape (Option-D) quotes the following character. '…' Single quote quotes all other characters. "…" Double quote quotes all characters except ∂, {, and `. /…/ Slash quotes all characters except ∂, {, and `. \…\ Backslash quotes all characters except ∂, {, and `. {…} Braces denote variable substitution. {{…}} … special characters are "escaped". `…` Backquotes denote command substitution. ``…`` … special characters are "escaped". ? Question mark matches any character in filename patterns. ≈ Approximately (Option-X) matches any string in patterns. […] Brackets enclose character sets in filename patterns. * Star indicates zero or more repetitions in patterns. + Plus indicates one or more repetitions in patterns. «…» European quotes (Option-\ and Option-Shift-\) enclose repeat counts. < Less-than indicates an input file specification. > Greater-than indicates an output file specification. >> Indicates appending to an output file specification. ≥ Greater-than-or-equal indicates a diagnostic specification. ≥≥ Indicates appending to a diagnostic file specification. ∑ Capital sigma (option-w) indicates both an output file and diagnostic output file specification. ∑∑ Indicates appending to the output and diagnostic file specification. … Ellipsis (Option-;) signals the Shell to use Commando - Expressions Numbers may be expressed in decimal, hexadecimal, octal, or binary. Any of the following formats may be used: [0-9]+ decimal number 0x[0-9a-f]+ hexadecimal number $[0-9a-f]+ hexadecimal number 0[0-7]+ octal number 0b[01]+ binary number The operators listed below are used in expressions in the Evaluate, If, Else If, Break, Continue, and Exit commands. Alternate spellings of several operators are provided. All of the operators are evaluated from left to right. Operators with the highest precedence are listed first, and operators in the same group have equal precedence. (…) expression grouping - unary negation ~ bitwise negation ! NOT ¬ logical NOT (¬ is Option-L) * multiplication ÷ DIV division (÷ is Option-/) % MOD modulus division + addition - subtraction << shift left >> shift right < less than <= ≤ less than or equal to (≤ is Option-<) > greater than >= ≥ greater than or equal to (≥ is Option->) == equal != <> ≠ not equal (≠ is Option-=) =~ equal to a pattern !~ not equal to a pattern & bitwise AND ^ bitwise XOR | bitwise OR && AND logical AND || OR logical OR - Selections - selections specify a selection or insertion point § current selection (Option-6) n line number n !n line n lines after end of current selection ¡n line n lines before start of selection (Option-1) position position (defined below) markerName selection marked by markerName pattern pattern (defined below) (selection) selection grouping selection:selection both selections and everything in between position - positions specify an insertion point • position before first character of file (Option-8) ∞ position after last character of file (Option-5) Δselection position before first character of selection (Option-J) selectionΔ position after last character of selection (Option-J) selection!n position n characters after selection selection¡n position n characters before selection (Option-!) pattern - patterns specify characters to be matched /entireRE/ regular expression - search forward \entireRE\ regular expression - search backward Help Patterns # See "Help Patterns" for more information. - Patterns - Patterns specify characters to be matched /entireRE/ regular expression - search forward \entireRE\ regular expression - search backward entireRE •RE regular expression at beginning of line (Option-8) RE∞ regular expression at end of line (Option-5) RE regular expression RE simpleExpr simple regular expression - defined below (RE)®digit tagged RE - refer to match as ®digit (Option-R) 'string' literal - no characters within '…' are special "string" literal - only ∂, {, and ` are special within "…" RE1RE2 regular expression RE1 followed by RE2 simpleExpr (RE) regular expression grouping charExpr single character regular expression - defined below simpleExpr* simple expression zero or more times simpleExpr+ simple expression one of more times simpleExpr«n» simple expression n times (Option-\, Option-Shift-\) simpleExpr«n,» simple expression at least n times simpleExpr«n1,n2» simple expression at least n1, at most n2 times charExpr character character (unless it has special meaning) ∂character character - defeats any special meaning (Option-D) ? any character except Return ≈ zero or more characters, except Return (Option-X) [charList] any character in the list [¬charList] any character not in the list (Option-L) charList [ [ first in the list represents itself ] ] first in the list represents itself - - first in the list represents itself character character charList character list of characters character-character character range (e.g. A-Z) - ShortCuts The following is a list of MPW Shell shortcuts: Double click select word Triple click select line Double Clicking on any of the characters (,),[,],{,},',",/,\,`,“,”,‘,’ will select everything between the character and its mate. LeftArrow move insertion point one character to the left RightArrow move insertion point one character to the right UpArrow move insertion point one line above current position DownArrow move insertion point one line below current position Opt-LeftArrow move insertion point one word to the left Opt-RightArrow move insertion point one word to the right Shift-LeftArrow extend selection one character to the left Shift-RightArrow extend selection one character to the right Shift-UpArrow extend selection one line above current position Shift-DownArrow extend selection one line below current position Shift-Opt-LeftArrow extend selection one word to the left Shift-Opt-RightArrow extend selection one word to the right Cmd-LeftArrow move insertion point to beginning of current line Cmd-RightArrow move insertion point to end of current line Cmd-UpArrow move insertion point up one screen size Cmd-DownArrow move insertion point down one screen size Cmd-Shift-LeftArrow extend selection to beginning of current line Cmd-Shift-RightArrow extend selection to end of current line Cmd-Shift-UpArrow extend selection up one screen size Cmd-Shift-DownArrow extend selection down one screen size Cmd-Opt-UpArrow move insertion point to beginning of file Cmd-Opt-DownArrow move insertion point to end of file Cmd-Shift-Opt-UpArrow extend selection to beginning of file Cmd-Shift-Opt-DownArrow extend selection to end of file Delete delete character to the left Del (Extended Keyboard) delete character to the right Shift-Delete delete character to the left Shift-Del delete character to the right Opt-Delete delete word to the left Opt-Del delete word to the right Cmd-Delete delete from current position to end of file Cmd-Del delete from current position to end of file Searching shortcuts Cmd-Shift-G reverse the direction of "Find Same" Cmd-Shift-H reverse the direction of "Find Selection" Cmd-Shift-T reverse the direction of "Replace Same" Holding down Shift while selecting OK will reverse the direction of "Find" and "Find and Replace" Holding down Option while selecting "Tile Windows" or "Stack Windows" will include the worksheet in the tiling or stacking Holding down Option while pressing Return will disable auto-indent for that line. Holding down Option while pressing Enter will invoke Commando on that command line. In Dialogs without an EditText item Y Yes N No CMD . Cancel ESC Cancel - AddMenu # add a menu item AddMenu ([(menuName | -help) [-asis] [item [command…]] > menuList) OR (-link menu item submenu]) -asis # no metacharacter translation for menu item name -help # a "menu name" for the balloon help menu -link menu item submenu # define hierarchical menu Note: Item can contain the following metacharacters ("<char>" means any character), unless the -asis option is used: /<char> Assign the keyboard equivalent Command-<char> !<char> Place <char> to the left of the menu item ^n Item has an icon, where n is the icon number ( Item is disabled <style Item has a special style: "style" can be any of the following: B Bold I Italic U Underline O Outline S Shadow Hierarchical menus are built like this: # Create submenu AddMenu SubMenu SubMenuItem1 "echo item1" AddMenu SubMenu SubMenuItem2 "echo item2" AddMenu SubMenu SubMenuItem3 "echo item3" AddMenu SubMenu SubMenuItem4 "echo item4" AddMenu SubMenu SubMenuItem5 "echo item5" #Create topmenu AddMenu Test Test1 "echo who cares" #now link it in AddMenu -link Test Test1 SubMenu - AddPane # split the window into panes AddPane [-p paneSpec] [-y ySplit | -h xSplit] [window] -p paneSpec # choose a pane to split -y ySplit # horizontal split at ySplit pixels from top -x xSplit # vertical split at xSplit pixels from left Note: paneSpec is an alternating catenation of strings of the form cm and rn, where m is a column ordinal and n is a row ordinal. - Adjust # adjust lines Adjust [option…] selection [window] -c count # repeat the Adjust count times -l spaces # shift lines by “spaces” spaces - Alert # display an alert box Alert [-s] [message…] < file -s # silent, don't beep when dialog is displayed - Alias # define or write command aliases Alias [name [word…]] > aliasList - Align # align text to left margin Align [-c count] selection [window] -c count # repeat the Align count times - Asm # MC68xxx Macro Assembler Asm [option…] [file…] < file > listing ≥ progress -addrsize size # set size of address display -blksize blocks # use blocks * 512 byte I/O buffers -case on # distinguish between upper and lower case -case obj[ect] # preserve case in object file -case off # ignore case (default) -c[heck] # syntax check only, don't create object file -d[efine] name # equivalent to: name EQU 1 -d[efine] name=value # equivalent to: name EQU value -d[efine] &name # equivalent to: &name SET[AC] 1 -d[efine] &name=value # equivalent to: &name SET[AC] value -e[rrlog] file # write errors and warnings to file -f # suppress page ejects in listing -font name[,size] # set listing font and size -h # suppress page headers in listing -i directory,… # search for includes in directory,… -l # write full listing to output -lo file # listing output file or directory -model cfmseg # generate a CFM-68K runtime compatible object file -model far # allow generation of load-time relocatable 32-bit references -model near # prohibit generation of load-time relocatable 32-bit # references (the default) -o objname # generate code in file or directory objname -pagesize l[,w] # set listing page length and width -print mode # equivalent to: PRINT mode -p # write progress information to diagnostics -s # write short listing to output -sym off # no symbolic records -sym on|full # full symbolic records; can modify with [,nolines] [,notypes] [,novars] -t # write time and total lines to diagnostics -w # suppress warnings -wb # suppress warnings on branch instructions - ATags # Create a tag file based on Asm source code ATags [option…] file… -k # keep tags from named files, remove all others -o filename # output to filename (default is "tags") -p # write progress information to diagnostics -r # remove tags from named files, keep all others -update # update existing tags file -w # issue warnings - AuthorInfo # print information about the authors in a project AuthorInfo [-u User] [-project Project] [-r] [-cs comment | -cf file] -u user # name of current user -project project # name of project that contains the symbolic names -r # recursively unobsolete names -cs comment # brief information about the author -cf file # the comment is contained in the file - Backup # folder file backup Backup [option…] -from folder -to folder [file…] > commands ≥ progress -a # copy all files in "from" not in "to" -ay # suppress delete command's -ay option -alt # alternate prompts for disk drives -busy folder # move busy files to specified folder -c # create "to" folders if they don't exist -check checkopt,… # produce reports based on checkopt # checkopt=from "from" not in "to" # to "to" not in "from" # allfroms "from" not in "to" even if none # alltos "to" not in "from" even if none # folders "from" folders not in "to" # newer "to"s newer than "from"s -co filename # redirect -check reports to filename -compare [only][,'opts']# write compare commands for out-of-date files -d # write delete commands for files in "to" not in "from" -do [only][,'command'] # write the command string specified by command… -e # eject disk when done -from folder|drive # specify source folder or drive (1 or 2) -l # write directory listing of "from" files -lastcmd 'command' # write the command string as the last command -level n # restrict -a and -d to files beyond level n -m # multi-disk -- more than one "from" or "to" disk -n # show folder nesting by indenting commands -noalias # suppress generation of commands that would affect alias files -p # write progress information to diagnostics -r # recursively process nested folders -revert # revert "to" files to their "from" state -since date[,time]|fname# process only files since specified time -sync # synchronize both source and destination folders -t type # process only files of specified type -to folder|drive # specify destination folder or drive (1 or 2) -y # suppress duplicate command's -y option Note: A date is mm/dd/[yy]yy [[hh:mm[:ss]] [AM|PM]] ([yy]yy < 100 assumes 20th century, e.g. 19yy) - Beep # generate tones Beep [note [,duration [,level]]]… # duration is given in sixtieths of a second (default is 15) # sound level is given as a number from 0 to 255 (default is 128) - Begin # group commands Begin command… End - Break # break from For or Loop Break [If expression] - Browser # invoke Marker Browser # The MPW Browser command is used to navigate source files or other text. It # presents a window containing a list of the files in the current directory # and, for the selected file, a list of markers. Double-clicking on the marker # opens the file with the selection point at the marker. Entering a marker name # in a text box searches all files in the directory for that marker, and if found # opens the file with the selection point at the marker. - BuildCommands # show build commands BuildCommands program [option…] > commands option… # Make command options - BuildMenu # create the Build menu BuildMenu - BuildProgram # build the specified program BuildProgram program [option…] > log option… # Make command options - Canon # canonical spelling tool Canon [option…] dictionary [file…] < file > new -s # case sensitive replacement -a # assembler identifiers (include $, %, @) -c n # consider only the first n characters - Catenate # concatenate files Catenate [file…] < file > catenation - CheckIn # check a file into a project CheckIn -w | -close | ([option…] files…) > progress -a # checkin all files in current directory -b # check in files… as branches -c # cancel if conflict occurs (avoids dialog) -cf file # the comment is contained in file. -close # close the Check In window -cs comment # a description of changes made to the file -delete # delete the file after checking it in -m # check out the files for modification after checking in -n # answer no to all dialogs (avoids dialogs) -new # add a new file to the project -p # write progress information to standard output -project project # name of project that contains the files -t task # a short description of task accomplished -touch # touch the mod date of file after checking in -u user # name of current user -verify # verify the contents of the checked in file -w # open the Check In window -y # answer yes to all dialogs (avoids dialogs) - CheckOut # check a file out from a project CheckOut -w | -close | ([option…] name…) > progress * -a # check out all the files in the current project -b # checkout specified files on a new branch -c # cancel if conflict occurs (avoids dialog) -cancel # cancel the checkout of the files -cf file # the comment is contained in files -close # close the Check Out window -cs comment # a short description of changes -d dir # directory where the checked out files should go -date date # check out revisions current on this date -deleteObsolete # delete obsolete files found in the checkout directory -history # store history in the ckid resource -m # check out a modifiable copy of the file -n # answer no to all dialogs (avoids dialogs) -newer # checkout latest copy of all files in the project -noTouch # don't touch the mod date of the checked out files -noWarn # don't report warning if project has no files -obsolete # checkout read-only version of obsoleted file -open # open the files after checking out -p # write progress information to standard output -project project # name of project that contains the files -r # recursively checkout files -t task # a short description of task accomplished -touchOnly # checkout and touch only those members of a nameRevisions # set that are not already checked out -u user # name of current user -update # checkout latest copy of all files you already have -verify # verify the contents of the checked out file -w # open the Check Out window -y # answer yes to all dialogs (avoids dialogs) * name = file name | NameRevisions name Note: A date is mm/dd/[yy]yy [[hh:mm[:ss]] [AM|PM]] ([yy]yy < 100 assumes 20th century, e.g. 19yy) - CheckOutDir # specify the directory where checked out files will placed CheckOutDir [-project project | -m] [-r] [-x | directory] -project project # name of project to associate with the checkout directory -m # list the checkout directories of all root projects -r # recursively set or display the checkout directories -x # reset the checkout directories to ":" - Choose # choose or list network file server volumes and printers Choose [option…] [zone]:[server[:volume]] … -askpw # ask for server password (in a "safe" dialog box) -askvp # ask for volume password (in a "safe" dialog box) -atalk # mount server via AppleTalk instead of TCP -c # display -list output in the form of "Choose" commands -cp # list name, type and driver of current printer -dr driverName # the driver name of the print server being mounted (e.g. "LaserWriter") -guest # log-in to the file server as a guest -list # list entities (don't choose them) -p # write version and progress information to standard output -pr # choose a print server (instead of file servers) -pw serverPassword # specify server password -type typeName # specify type of entity to list or choose (or '≈') -u userName # specify user name for server log-in -v # verbose (list all mounted file server volumes) -vp volumePassword # specify volume password The wildcard '≈' may be used in place of a zone, server, volume or type name. A leading ':' (empty zone name) or '*:' indicates the current zone. A name of the form "…server:" will mount all volumes on the server, unless a specific volume name is given. - Clear # clear the selection Clear [-c count] selection [window] -c count # repeat the Clear count times - Close # close specified windows Close [-y | -n | -c] [ -a | window…] -y # save modified windows before closing (avoids dialog) -n # don't save any modified windows (avoids dialog) -c # cancel if there is a modified window (avoids dialog) -a # close all the windows - CMarker # generate Mark commands for C and C++ function definitions CMarker [option…] [file…] -a[nachronisms] # suppress anachronisms messages -d[efine] name[=string] # define name to the preprocessor (same as #define) [,name[=string]]… -e # show macro expansion in the listing (default with -ppout) -ext[ensions] on|off # turn on or off Apple compiler extensions (default on) -errors # suppress marking if errors are detected -i[ncludes] pathname # search for include files in the specified directories (Max of 15) [,pathname],… -lang[uage] C|"C++" # specify target sources as either C or C++ (Default is C) -linesize n # maximum number of characters generated in a single listing line -l[ist[ing]] # generate a listing of the source to stdout -mc68881 # define the macro name mc68881 as having the value 1 -msi # mark include (header) files -pp # preprocessing only (no markers will be generated) -ppout filename # write the preprocessor output to the specified filename -p[rogress] # write version, progress and summary information to stderr -showskipped # show lines skipped by conditional compilation in the listing output -t # display processing time and number of lines to stderr -u[ndefine] name # undefine the preprocessor symbol name (same as #undef) [,name]… - Commando # present a dialog interface for commands Commando [command] [-modify] -modify # enable Commando’s built-in editor - Compare # compare text files Compare [option…] file1 [file2] < file2 > differences ≥ progress -b # treat several blanks or tabs as a single blank -c c1-c2[,c1-c2] # compare only specified columns -d depth # maximum stack depth -e context # display specified number of context lines -g groupingFactor # grouping factor (matching lines for resync) -h width # write differences horizontally -l # lower case (i.e. ignore case differences) -m # suppress displays of mismatched lines -n # don't write to output if files match -p # write progress information to diagnostics -s # use static grouping factor -selection set # highlight first mismatch (for CompareFiles only) -selection next # highlight next mismatch (for CompareFiles only) -t # ignore trailing blanks -v # suppress line numbers in vertical displays -w max # set max input line length to max (default: 255, max max: 1024) -x # don't expand tabs - CompareFiles # compare text files and interactively view differences CompareFiles [option…] oldFile (newFile | newDir) -9 # assume a screen size of 512 x 342 -LC | -12 # assume a screen size of 512 x 384 (12" RGB) -13 # assume a screen size of 640 x 480 -Portrait | -15 # assume a screen size of 640 x 870 (Apple Macintosh Portrait Display) -16 # assume a screen size of 832 x 624 (16" RGB) -17 # assume a screen size of 1024 x 768 -TwoPage | -21 # assume a screen size of 1152 x 870 (Apple Two-Page Monochrome Monitor) -b x y # tile windows into the rectangle specified by x y -r t,l,b,r # specify rectangle in global pixel coordinates; # 0,0 is upper left corner of primary monitor -compareOpts options # specify options to pass along to Compare tool -topdown # perform comparison from top to bottom - CompareRevisions # compare two revisions of a file in a project CompareRevisions file - Confirm # display a confirmation dialog box Confirm [-t] [message…] < file -t # three buttons (Yes, No, Cancel) Note: The following status values are returned: 0 "OK" selected in a two-button box, "Yes" in a three-button box 1 Syntax error 4 "Cancel" selected in a two-button box, "No" in a three-button box 5 "Cancel" selected in a three-button box - Continue # continue with next iteration of For or Loop Continue [If expression] - Copy # copy selection to Clipboard Copy [-c count] selection [window] -c count # copy the nth selection, where n = count - Count # count lines and characters Count [option…] [file…] < file > counts -l # write only line counts -c # write only character counts - CreateMake # create a simple makefile CreateMake [ -68k | -PowerPC | -Fat ] [ -Application | -Tool | -DA | -CR | -SIOW | -SHRLIB ] [ -sym on ] [ -depends ] [ -c creator ] [-export exportSymbol] [ -opt (local | size | speed1 | speed2 | speed3 | speed4) ] [ -mc68020 | -mc68881 | -elems881 ] [ -t fileType ] [ -m mainEntryPoint ] [ -rt resourceType ] [ -i path ] programname [file…] -Application # create an Application (default) -c creator # optional Creator for Application or Code Resource -Tool # create a Tool -DA # create a Desk Accessory -CR # create a Code Resource -SIOW # create a Simple Input/Output Window -export exportSymbol # specify an exported symbol for a shared library -m mainEntryPoint # required Main Entry Point for Code Resource -rt resourceType # required Resource Type for Code Resource -t type # optional File Type for Code Resource -sym on # include debugging information in the object file -mc68020 # generate 68020 instructions -mc68881 # generate 68881 instructions for elementary operations -elems881 # generate 68881 instructions for transcendental functions -depends # generate dependencies for include files for C and C++ source -PowerPC # generate code for the PowerPC microprocessor family -68K # generate code for the 68000 microprocessor family -opt local | size | # specify PowerPC C/C++ Compiler optimization options speed 1 | speed 2 # speed 3 | speed 4 # -SHRLIB # create a shared library (not yet implemented) -i path # specify an include file path to be searched for compiles. -fat # generate a "fat" application containing 68000-family # and PowerPC-family code. - Cut # copy selection to Clipboard and delete it Cut [-c count] selection [window] -c count # cut the next count selections - CTags # Create a tag file based on C source code CTags [option…] file… -c # honor conditional compilation directives -cplusplus # accept C++ syntax -d name # equivalent to #define name 1 -d name=string # equivalent to #define name string -decl # tag subroutine declarations -e # tag objects marked extern -f # force FILE not to be a datatype -h # don't tag included files -i directory # search for includes in directory -k # keep tags from named files, remove all others -l # ignore #line directives -local # tag local include files only -noduptypedefs # don't tag typedefs that duplicate struct, union, or enum tags -o filename # output to filename (default is "tags") -p # write progress information to diagnostics -r # remove tags from named files, keep all others -s # tag objects marked static -t name # name is considered a datatype -u # tag #undef'd words -update # update existing tags file -w # issue warnings - Date # write the date and time Date ([-a | -s | -s4 | -u] [-st] [-d | -t] [-c seconds | -utc]) | ([-n] [-utc]) | [-x date] > date -a # abbreviated date (e.g. Wed, Jun 14, 1995) -s # short date (e.g. 6/14/95) -s4 # short date, using 4-digit year (e.g. 6/14/1995) -u # uniform output format, "YYYY◊MM◊DD HH:MM:SS" -st # omit seconds from time format -d # write date only -t # write time only -c seconds # write date corresponding to seconds -x date # write seconds corresponding to date -n # write seconds since January 1, 1904 -utc # write output converted to Universal Time Coordinates - Delete # delete files and directories Delete [-y | -n | -c] [-i] [-p] name… ≥ progress -y # delete directory contents (avoids dialog) -n # don't delete directory contents (avoids dialog) -c # cancel if a directory is to be deleted (avoids dialog) -ay # delete alias files (avoids dialog) -an # don't delete alias files (avoids dialog) -ac # cancel if an alias file is to be deleted (avoids dialog) -i # ignore errors (no diagnostics) -p # write progress information to diagnostics - DeleteMenu # delete user-defined menus and menu items DeleteMenu [(menuName | -help) [itemName]] -help # a "menu name" for the balloon help menu - DeleteNames # delete user-defined symbolic names DeleteNames [-u user] [-project project] [-public | -private] [-r] [names… | -a] -u user # name of current user -private # delete private names -project project # name of project that contains the files -public # delete public names (the default) -r # delete names recursively -a # delete all names - DeletePane # delete panes from the window DeletePane [-p paneSpec | -a] [window] -p paneSpec # choose a pane to delete -a # reset the window to one pane Note: paneSpec is an alternating catenation of strings of the form cm and rn, where m is a column ordinal and n is a row ordinal. - DeleteRevisions # delete previous revisions of files in a project DeleteRevisions [option…] revision… -u user # name of current user -project project # name of project that contains the files -file # deletes the file and all its revisions -y # delete the file/revision (avoids dialog) - DeRez # resource decompiler DeRez [option…] resourceFile [file…] > description ≥ progress -c[ompatible] # generate output compatible with Rez 1.0 -e[scape] # don't escape chars < $20 or > $D8 -d[efine] name[=value] # equivalent to #define name [value] -i[nclude] pathname # search this path when looking for #include files -m[axstringsize] n # write strings n characters per line -noResolve # do not resolve leaf aliases for the resource file -only typeExpr # process only resources of this type -p[rogress] # write progress information to diagnostics -rd # suppress warnings for redeclared types -script language # specify the character set (see second Note) -s[kip] typeExpr # skip resources of this type -u[ndef] name # equivalent to #undef name Note: A typeExpr may have one of these forms: type "'type'(id)" "'type'(id:id)" "'type'(∂"name∂")" Note: The following languages may be used with the -script option: Roman (default) Japanese Korean SimpChinese TradChinese - Directory # set or write the default directory Directory [-q | directory] > directory -q # don't quote directories with special characters - DirectoryMenu # create the Directory menu DirectoryMenu [directory…] - DoIt # highlight and execute a series of shell commands DoIt (CommandFile [-echo] [-dump]) | [-selection] -echo # echo commands before execution -dump # dump unexecuted commands after error -selection # execute command in the current selection - DumpCode # write formatted CODE resources DumpCode [option…] resourceFile > dump ≥ progress -n # dump only resource names -d # don't dump object code -h # don't write headers (offsets, hex, etc.) -a # show offsets from beginning of segment -jt # don't dump jump table -di # don't dump data initialization info -ri # don't dump a5- and segment-relocation info -p # write progress information to diagnostics -r byte1[,byte2] # dump code from address byte1 (through byte2) -rt type[=id] # dump only resources with this type (and id) -s name # dump only resource with this name - DumpFile # display contents of any file DumpFile [option…] filename > dump ≥ progress -rf # display the resource fork of the file. (Default is data fork.) -bf # display both forks of the file -a # suppress display of ASCII character values. -a7 # ignore high-order bit when displaying ASCII text -h # suppress display of hexadecimal characters. -o # suppress display of file offsets. -w nn # width - display nn bytes on each line of output. -g nn # group nn bytes together without intervening spaces. -p # write progress information to diagnostic output. -r byte1[,byteN] # display only the byte range from byte1 to byteN. -noResolve # suppress alias resolution - DumpObj # write formatted object file DumpObj [option…] objectFile > dump ≥ progress -co # only dump disassembly -d # don't dump object code -h # don't write headers (offsets, hex, etc.) -i # use ids, rather than names, in dump -jn # just use names, rather than ids, in dump -l # dump file locations of object records -m name # dump only module "name" or module containing # entry-point "name" (-m option may be used repeatedly) -n # dump only the dictionary of names -p # write progress information to diagnostics -r byte1[,byte2] # dump code from byte1 in file (through byte2) -sym [Off] # disable symbolic output [On | Full] # enable symbolic output (default), can be followed by: [,NoLabels] # omit label information [,NoLines] # omit source line information [,NoTypes] # omit type information [,NoVars] # omit variable information -mods # dump a module summary with entry point information -mh # omit module summary header - DumpPEF # Display the contents of a PEF container DumpPEF [option…] file… > dump ≥ progress -a[nnotate] # annotate each PEF field. -cache on | off # enable/disable data caching (default is on) -c[heck] # check only, suppress all output -cont[ainer] n # process only container n (n ≥ 1) -dialect cpu[,vec[tor]] # set disassembly dialect to cpu, where cpu is: Power | Pwr # RS/6000 Power PowerPC601 | PPC601 # 601 PowerPC32 | PPC32 # 32-bit PowerPC PowerPC64 | PPC64 # 64-bit PowerPC vec[tor] # vector extensions -do All | optLetters # process all or selected PEF sections; optLetters: r # 'cfrg' + 'rseg' resources h # main header + section headers (default) y # section header string table a # all raw data sections except code and data c | t # code (text) section d # data section p # pidata section k # constant section x # exec data section l # loader section (hdrs + relocations + symbols) (default) g # debug section e # exception section b # trace back section -fmt fmtParams # same as -format. -forks whichForks # process only those containers in the specified fork(s). rsrc | resource # process only containers in resource fork data # process only containers in data fork both | all # process all containers in both forks (default) -format on | off[=opt] # specify code section formatting (default is off); opt: d # show d(RA) displacements in decimal instead of hex f # show fields in decimal instead of hex h | $ # show hex values with leading '$' instead of '0x' i | s # show signed immediates in decimal instead of hex m # show hex with the smallest even number of hex digits p # show PC-relative values in decimal instead of hex u # show unsigned immediates in decimal instead of hex x # show extended mnemonics (except when -dialect power) 2 # show neg hex in 2's comp. instead of negated hex -h # display this help info (or run tool with no arguments). -ibm # format disassembly using IBM assembly conventions. -ldr All | ldrLetter # finer control over loader (-do l) section; ldrLetter: h # loader header (default) f # loader import IDs i # loader import symbol table (default) r # loader relocation header + instructions (default) y # loader string table t # loader hash slot table c # loader export chain table x # loader export symbol table (default) n # loader export symbol names a # all except export slot and chain tables -loader ALL | ldrLetter # Same as -ldr. -mark # add MPW Shell markers to titles in output -maxlines n # limit section displays (except headers) to n lines. -o[ffsets] # suppress PEF container offsets. -p # display progress info to stderr. -pi[data] piLetter # further qualifies pidata (-do p) processing; piLetter: u # display the unpacked data produced by the pidata v # "vertical" pidata display (each rpt on new line) i # show only the pidata instructions and no encodings -sect[ion] n # limit section relative processing to only section n (n ≥ 0) -stripped # Suppress titles, break lines, summary info & offsets -summarize # summarize results (implied by -p). -u[nmangle] # unmangle symbols. -v[erbose] # same as -annotate. -w # suppress warnings. -w601 # show explicit warnings for Power instructions and 601 SPRs - DumpSYM # dump formatted SYM file DumpSYM [option] symFile -only t1[,t2…] # dump only listed tables -allbut t1[,t2…] # dump all tables except those listed Tables are: CLTE # Contained Label Table CMTE # Contained Module Table CSNTE # Contained Statement Table CTTE # Contained Type Table CVTE # Contained Variable Table FITE # File Information Table FRTE # File Reference Table MTE # Module Table RTE # Resource Table TINFO # Type Information Table TTE # Type Table # (same as TINFO but more human readable) - DumpXCOFF # write formatted XCOFF file DumpXCOFF [option…] xcoffFile… >output -a[nnotate] # Annotate each XCOFF field. -cache on | off # Enable/disable section hdrs, symbol and string tbl caching. -c[heck] # Check only. All output is suppressed on whatever is processed. -dialect cpu[,vec[tor]] # Set disassembly dialect to cpu, where cpu is, # Power | Pwr ==> RS/6000 Power # PowerPC601 | PPC601 ==> 601 # PowerPC32 | PPC32 ==> 32-bit PowerPC # PowerPC64 | PPC64 ==> 64-bit PowerPC # vec[tor] ==> vector extensions -do All | # Process the specified XCOFF sections, either "All" or optLetters # selected sections specified by one or more of the # optLetters: # h main header + opt aux header + section headers # r relocation information # n line number information # s symbol table + string table # y string table # a all raw data sections (except .pad) # l loader section # g debug section # c type check section # x exception section # i info (comment) section # t text section # d data section # b bss section -fmt fmtParams # Same as -format. -format fmtParams # Change standard disassembly formatting options. The # fmtParams has the following syntax: # <on> | <off> | <fmtParams>,<on> | <fmtParams>,<off> # <on> = ON=<fmtOptions> # <off> = OFF=<fmtOptions> # The <fmtOptions> are one or more of the following: # d show d(RA) displacements in decimal instead of hex # f show fields in decimal instead of hex # h | $ show hex values with leading '$' instead of '0x' # i | s show signed immediates in decimal instead of hex # m show hex with the smallest even nbr of hex digits # p show PC-relative values in decimal instead of hex # u show unsigned immediates in decimal instead of hex # x show extended mnemonics (except when -dialect power) # 2 show neg hex in 2's comp. instead of negated hex -h | -? # Display help info (or run tool with no arguments). -ibm # Format disassembly using IBM assembly conventions. -i dir1,... # Interlisting with dirN's as directory search paths. -ln # Show file/line numbers associated with disassembly. -m name1,... # Disassemble only the specified functions (name1,...). -mark # Add MPW Shell markers to titles in output. -m[ark]f[uncts] # Add markers to function labels (implies -mark). -maxlines n # Limit section displays (except headers) to n lines. -n[ames] spec # List symbol table or Loader section symbols ONLY, where # spec has the following syntax: # <keyword>[(<csectType>)][{<csectClass>}] # or, # <keyword>[,<csectType>][,<csectClass>] # and, # <keyword> = All | AllLdr | Funct[ion][s] | <symClass> | <ldrSymClass> # <symClass> = symbol table C_xxxx class (e.g., C_EXT) # <ldrSymClass> = <ldrClass> | <ldrSymClass><op><ldrClass> # <op> = '|' | '&' # <ldrClass> = Imp | Exp | Ent # <csectType> = the 'xx' of XTY_xx (ER,SD,LD,CM,HL,EM,US) # <csectClass> = the 'xx' of XMC_xx (PR, RO, RW, TC0, etc.) # Funct[ion][s] = "C_EXT(LD){PR}". # Note: Be careful of quoting if you use the braces in MPW! -ntb # Assume traceback tables are NOT present. -o[ffsets] # Suppress XCOFF file offsets. -only name1,... # Same as -m. -p # Display progress info to stderr. -powerOpen # Add validations specific to PowerOpen. -sect[ion] s # Limit section relative processing to only section s. # s is a number or a section name, e.g., ".text". -summarize # Summarize results (implied by -p). -tb # Disassemble traceback tables if present. -u[nmangle] # Unmangle symbols. -v[erbose] # Same as -annotate. -w # Suppress warnings. -w601 # Show explicit warnings for Power instructions (done only when # when -dialect is PPC601). -y # Suppress "beep" in -summarize Power instruction message -z c # Pathname separator char is 'c' (default ':'). Default options are: -dialect PPC601 -do htdb -fmt on=xsf -cache on - Duplicate # duplicate files and directories Duplicate [-y | -n | -c] [-p] [-d | -r] name… target ≥ progress -y # overwrite target files (avoids dialog) -n # don't overwrite target files (avoids dialog) -c # cancel if conflict occurs (avoids dialog) -p # write progress information to diagnostics -d # duplicate data fork only -r # duplicate resource fork only -rs # resolve leaf aliases in the source path(s) -rt # resolve leaf aliases in the target path -f # preserve Finder icon locations - DuplicateNameRevisions # duplicate symbolic names DuplicateNameRevisions [-u user] [-project project] [-public | -private] [-r] oldName newName -u user # name of current user -private # duplicate private names -project project # name of project that contains the names -public # duplicate public names (the default) -r # duplicate names recursively - Echo # echo parameters Echo [-n] [parameter…] > parameters -n # don't write return following the parameters - Eject # eject volumes Eject [-m] volume… -m # leave the volume mounted - Entab # convert runs of spaces to tabs Entab [option…] [file…] < file > tabbed ≥ progress -a minValue # Min run of blanks that can be replaced with a tab -d tabValue # input tab setting -l quote… # left quotes that prevent EnTab (default '") -n # no quote characters, EnTab everything -p # write progress information to diagnostics -q quote… # quotes that prevent EnTab (default '") -r quote… # right quotes that prevent EnTab (default '") -t tabValue # output tab setting - Equal # compare files and directories Equal [-d | -r] [-i] [-p] [-q] [-n count] name… target > differences ≥ progress -d # compare data forks only -r # compare resource forks only -i # ignore files in target not in directory name -n count # display only the number of difference instances # specified in "count" -p # write progress information to diagnostics -q # quiet - don't write output, just set {Status} -resolve # resolve leaf aliases on input paths - Erase # initialize volumes Erase [option…] volume… -y # yes - erase the disk (avoids dialog) -s # single-sided - 400K (default 800K) - Evaluate # evaluate an expression Evaluate [-h | -o | -b] [word…] > value Evaluate Name [binary operator]= expression -h # display result in hexadecimal (leading 0x) -o # display result in octal (leading 0) -b # display result in binary (leading 0b) - Execute # execute command file in the current scope Execute commandFile - Exists # confirm the existence of a file or directory Exists [-d | -f | -w] [-q] name… > file -a # write only paths to aliases (implies -n) -d # check if name is a directory -f # check if name is a file -n # do not resolve leaf aliases on input paths -w # check if name is a file and writeable -q # don't quote file names with special characters - Exit # exit from a command file Exit [status] [If expression] - Export # make variables available to commands Export [-r | -s | name…] > exports -r # generate Unexport commands for all exported variables -s # print the names only - FileDiv # divide a file into several smaller files FileDiv [option…] file [prefix] ≥ progress -b # input is a byte stream instead of lines -f # split file at formfeed character -n splitPoint # split file after splitPoint lines or bytes (-b) -p # write progress information to diagnostics -s n # set -b input buffer to n * 512 bytes - Files # list files and directories Files [option…] [name…] > fileList -af # expand the contents of the target of # leaf folder aliases; cannot be specified # together with -r -c creator # list only files with this creator -d # list only directories -f # list full pathnames -fr # list full pathnames with all aliases resolved -i # treat all arguments as files -l # long format (type, creator, size, dates, etc.) -m columns # n column format, where n = columns -n # don't print header in long or extended format -o # omit directory headers -q # don't quote filenames with special characters -r # recursively list subdirectories -s # suppress the listing of directories -t type # list only files of this type -x format # extended format with the fields specified by format Note: The following characters can specify the format a Flag attributes f Finder comments b Logical size, in bytes, of the data fork r Logical size, in bytes, of the resource fork c Creator of File ("Fldr" for folders) d Creation date k Physical size in kilobytes of both forks m Modification date t Type o Owner (only for folders on a file server) g Group (only for folders on a file server) p Privileges (only for folders on a file server) - Find # find and select a text pattern Find [-c count] selection [window] -c count # find the nth selection, where n = count - FindTag # output data associated with tag FindTag [option…] [tag] -a # use selection in active window as tag -f window # use selection in named window as tag -n # suppress stacking -p # stack request, suppress search -q # suppress the escaping of quotes in filenames -s # search all files in {TagsPath} - Flush # flush the tools that the Shell has cached Flush - FlushAllVolumes # write cached File Manager data structures to disk FlushAllVolumes - For # repeat commands once per parameter For name In word… command… End - Format # set or display formatting options for a window Format [[-f font] [-s fontsize] [-t tabsize] [-a attr]] | [-x fmt] [window…] -f fontName # set font to fontName -s fontSize # set the font size to fontSize -t tabSize # set the tab size to tabSize -a attr # set the auto indent and show invisibles flags -x fmt # output the current format in the specified format Note: The following attributes may be used with the -a option: A auto indentation on a auto indentation off I show invisibles on i show invisibles off L lock auto scrolling l unlock auto scrolling Note: The following characters may be used with the -x option: f font name s font size t tab size a attributes - Gestalt # output information about the operating environment Gestalt [option…] [selector…] -c # output only the number of bits in a Gestalt response -k # output the title even if only one selector is chosen -h # output the response as a hexadecimal number -s # output responses as strings if they exist in # Gestalt tool's database -e # generate error message if selector is not in data base -sel # output selector together with title and value -slots # output information about the cards in the machine slots -type # output info using only selectors which return a "type" -vers # output info using only selectors which return a "vers" -addr # output info using only selectors which return an "addr" -size # output info using only selectors which return a "size" -attr # output info using only selectors which return an "attr" -t n # entab the output with the specified value -t1 n # place one tab of the specified value between the # title and value -w n # write title in field of fixed width n (default: 24) -p # write version information -env # use SysEnvirons instead of Gestalt Manager - Get # get a record from an indexed file Get (dataFile… | -dfl listfFle) [-x] [-k key] [-width w] [-d default key] [-h | -h2] [-l] [-m] [-nf] [-q] [-s] [-search] [-t] [-sfl] [-y] [-field field list [-format format string] ] [-lessFields field list] dataFile # a specially formatted help file which must be # accompanied by an index file whose name is of # the form: dataFile.index, and whose type is 'btre' -dfl listFile # listFile contains a list of datafiles -k keyword # keyword in the datafile's index file -width w # column format for key lists, w = 1..200 is the # window width in characters -d default # use default keyword if no keyword is specified -h # write full header -h2 # write short header (only the used datafile) -l # list all keys in the first data file that begin # with nnn, where nnn is the keyword following -k -lessFields tag [,tag]… # remove the named items from the existing field # list (default list or as specified by -field) -m # select the key word that was found and assign # a marker to the selection -nf # no filtering; include field tags -q # quiet output when keyword not found -s # use the selection in the active window as keyword -search # text search datafile for occurrences of keyword -t # write out template of the requested function/procedure -field tag[,tag]… # specify the data field(s) to display -format format_string # specify string(s) to be output in front of data # specified in -field option. '%s' flags in string # correspond ordinally to tags in -field option -sfl # produce ordered list of data files # (requires -dfl listFile) -x # create or update the cross reference index file -y # do not present dialog before (re)building index file - GetErrorText # display error messages based on message number GetErrorText [-f filename] [-s filename] [-n] [-p] errnbr[,insert,…] … GetErrorText -i idnbr,… -f filename # explicit error msg file -i idnbr # report meaning of System Error Handler ID number -n # suppress error numbers in displayed messages -p # write version info to diagnostics -s filename # explicit system error msg file (default SysErrs.Err) - GetFileName # display a Standard File dialog box GetFileName [-q] [-s] [-c | [(-t type)… | -p | -d | -wd] [-m message] [-b buttontitle] [pathname]] -b buttontitle # specify the default button's title -c # write current standard file path to standard output -d # select a directory -wd # select a directory on a non-locked volume -m message # specify a prompt -p # select a new filename (SFPutFile) -q # suppress quoting of filenames -s # return 0 status even if cancel is clicked -t type # specify file type for SFGetFile dialog - GetListItem # display items for selection in a dialog box GetListItem [option…] [[item…] | < file] -c[ancel] # return a status of 0 even when cancel is clicked -d[efault] item # item is entered in list and comes up selected -m[essage] message # display message in dialog above the list -q[uote] # don't quote items in the output -r[ows] rows # make the list with this many rows -s[ingle] # only allow a single selection -sort # display list items in alphabetic order -w[idth] width # make the list this many pixels wide - Help # write summary information Help [-f helpfile] [command…] > helpInformation -f helpfile # alternate helpfile (default MPW.Help) - HideWindows # hide specified windows HideWindows [-except] window… -except # hide all window except named ones - If # conditional command execution If expression command… [Else If expression command… ] … [Else command… ] End - ILink # incrementally link an application, tool, shared library or resource ILink [option…] file… > map ≥ progress -ac n # align code modules on n-byte boundaries # (default: 2 if -model near/far, 8 if -model cfmseg/cfmflat) -ad n # align data modules on n-byte boundaries # (default: 2 if -model near/far, 4 if -model cfmseg/cfmflat) -br off | # don't generate branch islands (default) on | 020 | # generate 68020 branch islands where needed 68k # generate 68000 branch islands where needed -c resType # set output file creator (default: ????) -compact # compact the output file's resource fork -d # suppress warnings about duplicate symbol definitions -da # desk accessory - add NULL to segment names -@export fileName # export symbols specified in text file, one symbol per line -export name[,name]… # export the specified symbols -fragname name # set PEF container fragment name (default: name of output file) -init name # set initialization entry point -initbefore name[,name]…# mark the specified import libraries as "init before" # note - this option takes fragment names not file names -l # write a link map to standard output for use by performance tools -la # -l, include anonymous symbols in link map -m[ain] name # set main entry point -ma name=alias # create an alias for a module name -map # write a formatted link map to standard output -[no]mf # [don't] use temporary memory (default: mf) -model cfmflat | # generate a "flat" CFM-68K runtime compatible output file cfmseg | # generate a segmented CFM-68K runtime compatible output file far | # enable 32-bit load-time relocatable references near # prohibit 32-bit references (default) -msg keyword[,keyword]… # message options [no]dup # [don't] report warnings about duplicate symbol definitions [no]warn # [don't] report warning messages -newerdeps # relink only the object files specified on the command line -o fileName # set output file name (default: Link.Out) -opt on | off # enable Object Pascal optimizations (default: on) -p # write progress information to diagnostics -packdata off | # don't compress the PEF container's data section on | # compress the PEF container's data section (default) faster # use a potentially faster compression algorithm -pad n # pad segments to n-byte boundaries, n must be 0 or a # multiple of 512 (default: 512) -pm on | off # use purgeable memory when reading object files (default: off) -ra [seg]=attr[,attr]… # set resource attributes of specified segment or all segments # attr = a resource attribute name or its hex or decimal equivalent -rn # don't include resource names in output file -rt resType=resID # set resource type and ID -sg newSeg[=old[,old]…] # merge old segments into newSeg -sn oldSeg=newSeg # change segment name oldSeg to newSeg -state [no]use | # [don't] use state file (default: use) [no]rewrite # [don't] rewrite state file (default: norewrite) -t resType # set output file type (default: 'APPL' if -xm e, 'SPEF' if -xm s) -term name # set termination entry point -uf fileName # report unused code and data symbols to specified file -unmangle on | off # unmangle C++ symbols in link map and messages (default: on) -vercur n # set PEF container "current version" to n (default: 0) -verdef n # set PEF container "definition version" to n (default: 0) -verimp n # set PEF container "implementation version" to n (default: 0) -w[arn] # suppress warning messages -@weak fileName # mark imports specified in text file as "weak", one import per line -weak name[,name]… # mark the specified imports as "weak" -weaklib name[,name]… # mark the specified import libraries as "weak" # note - this option takes fragment names not file names -wrap # put excess jump table entries in global data space, if available -xm e[xecutable] | # generate an application or tool (default) s[haredlibrary] # generate a shared library - ILinkToSYM # generate .SYM file from ILink state file ILinkToSYM [option…] <appName>.NJ ≥ progress -c[sym] resType # set output file creator (default: 'Alar') -[no]mf # [don't] use temporary memory (default: mf) -o fileName # set output file name (default: <appName>.SYM) -p # write progress information to diagnostics -pg n # set output file page size to n # n must be a multiple of 512 (default: 4096) -sym 3.2 | # generate version 3.2 SYM file format 3.4 | # generate version 3.4 SYM file format 3.5 | # generate version 3.5 SYM file format on # generate version 3.5 SYM file format (default) - Lib # combine object files into a library file Lib [option…] objectFile… ≥ progress -d # suppress duplicate definition warnings -df deleteFile # delete modules listed in file deleteFile -dm name[,name]… # delete external modules and entry points -dn name[,name]… # delete external names, making them local -dnx name[,name]… # delete all external names, except those listed -f # allow FORTRAN-style common data -mf # use MultiFinder temporary memory if necessary -o name # write object file name (default Lib.Out.o) -p # write progress information to diagnostics -rn OldNameA=NewNameA # change module name(s) OldNameA to NewNameA, [,OldNameB=NewNameB]… # OldNameB to NewNameB, etc. -sg newSeg[=old[,old]…] # merge old segments into new segment -sn oldSeg=newSeg # change segment name oldSeg to newSeg -sym On | Full # keep symbolic information (default), can be followed by: [,NoLabels] # discard label information [,NoLines] # discard source line information [,NoTypes] # discard type information [,NoVars] # discard variable information -sym Off # discard symbolic information -ver N # set OMF file version number to N -w # suppress warnings - Line # find line in the target window Line n - Link # link an application, tool, or resource Link [option…] objectFile… > map ≥ progress -ac alignment # align code modules to 'n' byte boundaries -ad alignment # align data modules to 'n' byte boundaries -br off # do not generate branch islands (default) -br on # generate branch islands where needed -br 020 # generate 32-bit branch islands where needed -c creator # set resourceFile creator (default ????) -cSym creator # set .SYM file creator (default = 'sade') -d # suppress duplicate definition warnings -da # desk accessory - add NULL to segment names -f # allow FORTRAN-style common data -l # write a location map to output -la # -l, include anonymous symbols in location map -lf # -l, include file and location of definitions -m mainEntry # use mainEntry as main entry point -ma name=alias # create an alias for module name -map # generate "friendly" link map -mf # use MultiFinder temporary memory if necessary -mfMax # use ALL AVAILABLE MultiFinder temporary memory -nomf # don't use temporary memory (the default) -model far # process 32-bit load-time relocatable references -model near # prohibit 32-bit load-time relocatable references -msg keyword[,…] # message options [no]dup # (suppress) warnings about duplicate symbols [no]multiple # (suppress) multiple undefined symbol reports [no]warn # (suppress) warning messages -newerdeps # ignored--for compatibility with ILink -o outputFile # write to outputFile (default: Link.Out) -opt Off # disable Object Pascal optimizations (default) -opt On # enable optimizations [,Info] # write optimization information to diagnostics [,Names] # include MacsBug symbols within SelectorProc modules -opt NoBypass # enable optimizations, but always dispatch [,Info] # write optimization information to diagnostics [,Names] # include MacsBug symbols within SelectorProc modules -p # write progress information to diagnostics -pg size # set page size to "size"; max: 32K; min: 1024; default: 4096 -ra [seg]=attr[,attr…] # set segment resource attributes: $xx (or) nnn # a hex or decimal attribute you figure out resSysHeap # or a comma-separated list of resource resPurgeable # attributes by name resLocked # resProtected # resPreload # resChanged # (essentially ignored) -rn # don't include resource names in outputFile -rt type=id # set resource type and id -sg newSeg[=old[,old]…] # merge old segments into new segment -sn oldSeg=newSeg # change segment name oldSeg to newSeg -srt # sort global data by "near" and "far" references (default) -srtsg all|segName # place items referenced through Jump Table low in code resource. # all: sort all segments. # segName: sort named one. -state # ignored--for compatibility with ILink -sym Off # disable symbolic output (default) -sym On | Full # enable symbolic output, can be followed by: [,NoLabels] # omit label information [,NoLines] # omit source line information [,NoTypes] # omit type information [,NoVars] # omit variable information [,3.2] # generate version 3.2 SYM file [,3.3] # generate version 3.3 SYM file [,3.4] # generate version 3.4 SYM file (default) -t type # set resourceFile type (default APPL) -uf unrefFile # write list of unreferenced modules to unrefFile -w # suppress warnings -wrap # when jump table space is exhausted, put excess jump table # entries in global data space, if available -x crossRefFile # write cross reference to crossRefFile - LockNameRevisions # lock a symbolic name LockNameRevisions [-u User] [-project Project] [-password password] [-r] [names… | -a] -u user # name of current user -project project # name of project that contains the symbolic names -password password # the password for this lock -r # recursively lock names -a # all the symbolic names in the project - Loop # repeat commands until Break Loop command… End - Make # build up-to-date version of a program Make [option…] [target…] > commands ≥ progress -d name[=value] # define variable name (overrides makefile definition) -e # rebuild everything regardless of dates -f filename # read dependencies from specified file (default: MakeFile) -i dirname # additional directory to search for include files -p # write progress information to diagnostics -r # display the roots of the dependency graph -s # display the structure of the dependency graph -t # touch dates of targets and prerequisites -u # write list of unreachable targets to diagnostics -v # write verbose explanations to diagnostics (implies -p) -w # suppress warning messages -y # like -v, but omit announcing up-to-date targets - MakeDepend # generate makefile dependencies for "include" files MakeDepend [option…] source_files… [explicit_dependencies…] ≥ progress name=[value] # define a macro -append filename # append generated dependencies to specified makefile (default: stdout) -d name[=value] # define a macro -i dirname # additional directory to search for all types of included files -ia dirname # additional directory for Assembler INCLUDE/LOAD files -ic dirname # additional directory for C/C++ #include files -ip dirname # additional directory for Pascal USES/{$U…}/{$I…} files -ir dirname # additional directory for Rez #include/Include/Read/$$Resource/$$Read files -ignore dirname # ignore files from this directory (eg. {CIncludes}) -objdir dirname # directory for object files (default: the current directory) -objext extension # object file extension (default: ".o") -p # write progress information to diagnostics -quote on | off # control quoting of filenames (default: on) -w # suppress warning messages source_files are specified as source file names: :Sources:main.c explicit_dependencies are specified as dependency rules: :LibFiles:CommonLib.o ƒ :SourceFiles:CommonRoutines.c - MakeErrorFile # create error message textfile MakeErrorFile [option…] [file…] < file > listing ≥ progress -l # write listing to standard output -o file/dir # output file or directory -p # write progress information to diagnostics - MakeFlat # flatten a segmented shared library created by ILink MakeFlat [option…] inputFile ≥ progress -h[elp] # display this help info -o # specify output file -omitseghdrs # omit segment headers in the output file -p # enable progress messages -packdata off # don't compress the PEF container's data section -packdata on # compress the PEF container's data section (default) -packdata faster # use a potentially faster compression algorithm -share shareMode # set data section sharing mode (shareMode) to one of: context # shared within a context (default) global # shared across all contexts -w # disable warning messages - MakePEF # XCOFF to PEF converter MakePEF [option…] file (number arguments are read in decimal unless preceded by 0x ie:0x100 = hex 100) -a n # align code & data sections to n byte boundary (def=8) -b # expand bss into zeroed data (def=no) -c n # set current-version to n (def=0) -e name # set entry point to routine name (def=what-XCOFF-says) -d n # set definition version to n (def=0) -ft type # set output file type to "type" (e.g. APPL) -fc creator # set output file creator to "creator" (e.g. PETE) -f fname # use file fname to load additional export list -i name # set initialization routine to procedure name (def=none) -k # keep init, term & main routines as export symbols # (def=remove) -l oldname[=newname][#vers[-upfv]][!] # change imported library with # name oldname: =newname # to newname #vers # to current-version vers (# required) -upfv # to up-from-version upfv ! # to init before -n # pad exported loader symbols with trailing null # (def=nonull) -o fname # set the target output file name (def=a.peff) -r # mark data section as read-only (def=read-write) -s n # set share option of data section to n (def=contextShare) -t name # set termination routine to procedure name (def=none) -u n # set implementation version to n (def=0) -v n=m # make section n have default virtual address m (def=0) -w n:nam # make import name from file n weak (OK to be undef at # runtime) -x # turn off automatic data section packing - MakePPCCodeRsrc # create a PowerPC code resource from a PEF file MakePPCCodeRsrc inputfile -rt restype=id [option…] -a[ppend] # append the resource to the output file -c creator # set the output file creator -o outputfile # specify the output file (default: <inputfilename>.rsrc) -ov # ok to overwrite protected resource when appending -ra attributes # specify the resource attributes -rawpef # don't add a resource descriptor -rn resname # specify the resource name -rt restype=id # specify the resource type and ID -t filetype # set the output file type - MakeStub # create a PowerPC, CFM-68K or fat stub library MakeStub [option…] file… ≥ progress -arch fat | # create a fat stub library m68k | # create a CFM-68K stub library pwpc # create a PowerPC stub library (default) -c resType # set output file creator (default: 'MPS ') -d # suppress duplicate symbol warnings -fragname name # set fragment name (default: name of output file) -[no]mf # [don't] use temporary memory (default: nomf) -o fileName # set output file name (default: MakeStub.out) -p # write progress information to diagnostics -t resType # set output file type (default: 'stub') -vercur n # set the "current version" to n (default: 0) -verdef n # set the "definition version" to n (default: 0) -verimp n # set the "implementation version" to n (default: 0) -w[arn] # suppress warning messages -weakstub on | off # create a "weak" stub library (default: off) - MakeSYM # extract debugging information from XCOFF MakeSYM <XCOFFfile> [option…] -i directory # specifies directory for source files (default=current dir.) -notypes # don't include type information in xSYM file -o xsymfile # name output xSYM file 'xsymfile' (default=<appname>.xSYM) -only sourcefile… # include debugging info only from specified file(s) -p # write progress information to stderr -r # makes search for source files recursive -sym on | off | big # enable/disable generation of symbolic debugging information. off # disable generation of symbolic debugging information. on # enable generation of symbolic debugging information. big # use when PPCLink used the option -sym big -sym 3.2 # use the 3.2 SYM file format -sym 3.4 # use the 3.4 SYM file format (default) -v # display the MakeSYM version number -w # suppress warning messages. - Mark # assign a marker to a selection Mark [-y | -n] selection name [window] -y # replace existing marker (avoids dialog) -n # don't replace existing marker (avoids dialog) - Markers # list markers Markers [-q] [window] -q # don't quote the marker names - MatchIt # semi-intelligent language sensitive bracket matcher MatchIt [-a[sm] | -p[ascal] | -c] [-h] [-l] [-n] [-v] [window] -a[sm] # target language is Assembler -p[ascal] # target language is Pascal -c # target language is C -h # highlight all characters enclosed by match -l # highlight entire lines containing match -n # generate error message if no match -v # display MatchIt's version number - MergeBranch # merge a branch revision onto the trunk MergeBranch file - MergeFragment # merge code fragments MergeFragment [option…] [file…] target file -a # set 'cfrg' usage type to application -c # create default cfrg (meaningful only if no input files) -d # tag the data fork of the target in its 'cfrg' as not a # code fragment -n name # use "name" for cfrg entry -p # report progress -r # create 'rseg' cfrg entry -t pwpc|m68k # set architecture for created cfrg entry (default=pwpc) -u # set 'cfrg' updateLevel to update library -x # delete any existing 'cfrg' entry in the target -z # truncate the data fork of the target file before merging - ModifyReadOnly # enables read-only Projector files to be edited ModifyReadOnly file… - ModPEF # extract, delete and/or modify PEF fragments ModPEF [option…] file ≥ progress -@addexports fragSpec=fileName # add exported symbols to fragment -@alias fragSpec=fileName # add export aliases to fragment -c resType # set output file creator -delete fragSpec[,fragSpec]… # delete fragments -deleteexports fragSpec=name[,name]… # delete exported symbols from fragment -@deleteexports fragSpec=fileName # delete exported symbols from fragment -describe on | off # describe changes (default: on) -extract fragSpec[,fragSpec]… # extract fragments -[no]initbefore fragSpec=name[,name]… # modify fragment's "initbefore" settings -level fragSpec=base | update # change fragment's "level" -list # list contents of input file -mergecode on | off # make code sections adjacent (default: off) -[no]mf # [don't] use temporary memory (default: nomf) -o fileName # set output file name -p # write progress information to diagnostics -renamefrag fragSpec=name # rename a fragment -@renamesymbols fragSpec=fileName # rename fragment's imported/exported symbols -share fragSpec=context | global | protected | aNumber # change fragment's data section sharing -stacksize fragSpec=aNumber # change fragment's stack size -t resType # set output file type -usage fragSpec=lib[rary] | app[lication] | dropin | stub | weakstub | aNumber # change fragment's usage type -v # use verbose progress (implies -p) -vercur fragSpec=aNumber # change fragment's current version -verdef fragSpec=aNumber # change fragment's definition version -verimp fragSpec=aNumber # change fragment's implementation version -w[arn] # suppress warning messages -[no]weak fragSpec=name[,name]… # modify fragment's weak imports -@[no]weak fragSpec=fileName # modify fragment's weak imports -[no]weaklib fragSpec=name[,name]… # modify fragment's weak libraries A "fragSpec" identifies a particular fragment within a file. Its syntax is - fragSpec ::= fragName[(fragInfo[,fragInfo]…)] A "fragName" is the name of a fragment and is case-sensitive. Its syntax is - fragName ::= characters other than '(', ')', '=' and ',' fragName ::= '*' # matches any fragment name A "fragInfo" provides additional information which is used to identify a particular fragment within a file. Its syntax is - fragInfo ::= [arch=]pwpc | [arch=]m68k | arch=aNumber | [usage=]lib[rary] | [usage=]app[lication] | [usage=]dropin | [usage=]stub | [usage=]weakstub | usage=aNumber | [level=]base | [level=]update | level=aNumber | vercur=aNumber | verdef=aNumber - Monitors # show coordinates of monitor rectangle Monitors [Monitor #]… - Mount # mount volumes Mount drive… - MountProject # mount projects MountProject ([-s] [-pp] [-q] [-r]) | [Project [-only]] -only # do not mount subprojects -s # print names only, not commands -pp # list mounted projects using project paths -q # don't quote names with special characters -r # list projects recursively - Move # move files and directories Move [-y | -n | -c] [-p] name… target ≥ progress -y # overwrite target files (avoids dialog) -n # don't overwrite target files (avoids dialog) -c # cancel if conflict occurs (avoids dialog) -p # write progress information to diagnostics -rs # resolve leaf aliases in the source path(s) -rt # resolve leaf aliases in the target path -f # preserve Finder icon locations - MoveWindow # move window to h,v location MoveWindow [h v] [-i] [window] h # horizontal position of top left corner v # vertical position of top left corner -i # ignore positioning errors - MrC # C Compiler for Macintosh On RISC MrC [option…] file -alias off # Disable pointer alias analysis (default) -alias [addr] # Enable pointer alias analysis by distinct address [,ansi] # Enable pointer alias analysis by ANSI rules [,type] # Enable pointer alias analysis by data type -align power # specify power alignment for data structures (default) -align mac68k # specify 68K alignment for data structures -align byte | packed # use byte alignment for data structures -alloca # recognize 'alloca' as a built in function -ansi off # don't enforce strict ANSI compatibility (see the Symantec C/C++ for MPW # Users Guide.) -ansi on | relaxed # size of enums is determined by minimum size needed to # store the enum values. The following keywords will not # be recognized: “__handle”, “_inf”, “__nan”, “__nans”, # “__machdl”, “asm”, and “pascal”. (See MrC/MrCpp Release # Notes for complete list of features and restrictions.) -ansi strict # same as -ansi on, but size of enums is always an int -asm # generate an assembly listing of the generated code -char signed # treat char type as signed (default) -char unsigned # treat char type as unsigned -char unsignedx # treat char type as unsigned, and sign extend the values -c # Syntax check only. No XCOFF file is generated. -curdir # use current (working) directory for the compiler temporary # and output files. The -y option has precedence over the -currdir option. -d[efine] name # define a preprocessing symbol. Equivalent to #define name 1. -d[efine] name=value # define a preprocessing symbol. Equivalent to #define name value. -dump[c] filename # save the state of the compilation in the specified file -e # if -l is specified, show macro expansions in listing -enum int # use int-sized enumeration types -enum min # use minimum-sized enumeration types, same as 68K (default unless -ansi strict is on) -export_list filename # specify the file which contains a list of the shared library's exported entry points # (used in conjunction with -shared_lib_export). default: <source filename>.x -fatext # add “.ppc.o” extension to object filename instead of “.o” -fp_contract on # generate multiply-add-fused instructions (default) -maf on # " " " " -fp_contract off # don't generate multiply-add-fused instructions -maf off # " " " " -i pathname[,pathname…] # search for include files in directory specified by pathname -ieee relaxed | strict # control strict adherence to IEEE floating point semantics -ignorepragma id,… # ignore #pragmas with the specified #pragma id's -inclpath normal | std # treat <...> includes as system includes | standard # " " " " " " -inclpath ignoresys | # treat <...> includes exactly like "..." includes ignoresystem |# " " " " " " " nosys | # " " " " " " " nosystem # " " " " " " " -includes mac | # controls how to interpret #include pathnames (mac is default) dos | # convert DOS pathnames to Mac pathnames unix # convert Unix pathnames to Mac pathnames -inline all # functions are inlined wherever possible, regardless of cost -inline on # functions are inlined as defined in the C++ source (default) -inline none | off # inlining of C++ function expansions will be suppressed -inline 0 | 1 | 2 | 3 | # sets complexity limit on functions to be inlined. 4 | 5 # -ir pathname[,…] # recursively search for include files in directory specified by pathname -j0 # accept two byte sequences for Japanese -j1 # accept two byte sequences for Taiwanese or Chinese -j2 # accept two byte sequences for Korean -l filename # generates a listing to the specified file (need -e for macro expansions) -ldsize 64 | 128 # determines the size of long doubles (default = 64) -load[c] filename # restore the state of the compilation from the specified file -longlong off # disable support of long long types -longlong on # support long long types (default) -make filename # generate Make dependency rules into the specified file -noMapCR # changes the default mapping of \n to 0x0A and \r to 0x0D -notOnce # allow multiple copies of header files -o filename | dirname: # specify output filename or directory -opt off # suppress all optimizations (default with -sym on) -opt local # perform local optimizations (default with -sym off) -opt size # optimize for size [,warn_uninit] # warn about variables which are definitly used before being set [,warn_maybe_uninit] # warn about variables which may used before set [,ok_to_reduce_opt] # warn about reducing optimization level due to low memory -opt speed # optimize for speed [,unroll] # as above, plus loop unrolling [,unswitch] # as above, apply loop unswitching [,norep] # as above, but do not repeatedly apply global copy propagation # and redundant store elimination [,nointer] # as above, but no interprocedural optimizations [,warn_uninit] # warn about variables which are definitly used before being set [,warn_maybe_uninit] # warn about variables which may used before set [,ok_to_reduce_opt] # warn about reducing optimization level due to low memory -p # output progress information to the standard error file -poolstringsbyfunc # string constants are associated with their functions instead of compilation unit -prefix pathname # #include the specified file(s) prior to reading the first source file. [,pathname…] # -proto strict # require function prototypes -proto auto # automatically generate function prototypes (default) -shared_lib_export on # create a shared library and create file that contains entry point list -shared_lib_export off # don't create shared library (default) -sym off # disable generation of symbolic debugging information (default) -sym on | full # enable generation of symbolic debugging information [,nolines] # omit source line information [,notypes] # omit type information [,novars] # omit variable information [,alltypes] # generate type information for all types (including unreferenced types) -t # display compilation time -target ppc | powerpc # generate code for PowerPC architecture -target power # generate code for Power architecture -target 601 # generate code for PowerPC 601 -target 603 # generate code for PowerPC 603 -target 604 # generate code for PowerPC 604 -tb on # generate IBM RS/6000 traceback tables (same as -traceback) -tb pragma # generate IBM RS/6000 traceback tables only for #pragma traceback functions -tb exp[ort] # generate IBM RS/6000 traceback tables only for #pragma export functions -tb outofline # generate IBM RS/6000 traceback tables only for #pragma outofline functions -traceback # generate IBM RS/6000 traceback tables -typecheck strict # perform strict type checking (default). -typecheck relaxed # perform relaxed type checking -u all # #undef all predefined non-ANSI macros -u name[,…] # #undef name, where name is a predefined non-ANSI macro name -unique_strings # force all string constants to be unique -vec[tor] off # do not accept vector functions and types (default) -vec[tor] on # accept vector functions and types [,vrsave | # maintain VRsave in prologs and epilogs (default if -vector on) ,novrsave] # do not maintain VRsave in prologs and epilogs -w off # suppress all warnings -w [is]err[or] # treat warnings as errors -w n1[,n2…] # suppress the specified warning messages -x # continue past the normal maximum error limit (4) -y directory # write compiler temporary and object files to directory (default:same as source file) - MrCpp # C++ Compiler for Macintosh On RISC MrCpp [option…] file -alias off # Disable pointer alias analysis (default) -alias [addr] # Enable pointer alias analysis by distinct address [,ansi] # Enable pointer alias analysis by ANSI rules [,type] # Enable pointer alias analysis by data type -align power # specify power alignment for data structures (default) -align mac68k # specify 68K alignment for data structures -align byte | packed # use byte alignment for data structures -alloca # recognize 'alloca' as a built in function -ansi off # don't enforce strict ANSI compatibility (see the Symantec C/C++ for MPW # Users Guide.) -ansi on | relaxed # size of enums is determined by minimum size needed to # store the enum values. The following keywords will not # be recognized: “__handle”, “_inf”, “__nan”, “__nans”, # “__machdl”, “asm”, and “pascal”. (See MrC/MrCpp Release # Notes for complete list of features and restrictions.) -ansi strict # same as -ansi on, but size of enums is always an int -ansifor # limit for-statement declared initializer to the for body -aslm # for ASLM compatibility, reverts to old vtable format(incompatible with exceptions) -asm # generate an assembly listing of the generated code -bool on # enable C++ 'bool', 'true', and 'false' as standard keywords -bool off # 'bool', 'true', 'false' are normal identifiers (default) -char signed # treat char type as signed (default) -char unsigned # treat char type as unsigned -char unsignedx # treat char type as unsigned, and sign extend the values -c # Syntax check only. No XCOFF file is generated. -curdir # use current (working) directory for the compiler temporary # and output files. The -y option has precedence over the -currdir option. -d[efine] name # define a preprocessing symbol. Equivalent to #define name 1. -d[efine] name=value # define a preprocessing symbol. Equivalent to #define name value. -dump[c] filename # save the state of the compilation in the specified file -e # if -l is specified, show macro expansions in listing -EH # enable exception handling (same as -exceptions on) -enum int # use int-sized enumeration types -enum min # use minimum-sized enumeration types, same as 68K (default unless -ansi strict is on) -ER # enable run-time type identification (RTTI, same as -rtti on) -exceptions on | off # enable/disable exception handling (default off) -export_list filename # specify the file which contains a list of the shared library's exported entry points # (used in conjunction with -shared_lib_export). default: <source filename>.x -fatext # add “.ppc.o” extension to object filename instead of “.o” -fp_contract on # generate multiply-add-fused instructions (default) -maf on # " " " " -fp_contract off # don't generate multiply-add-fused instructions -maf off # " " " " -i pathname[,pathname…] # search for include files in directory specified by pathname -ieee relaxed | strict # control strict adherence to IEEE floating point semantics -ignorepragma id,… # ignore #pragmas with the specified #pragma id's -inclpath normal | std # treat <...> includes as system includes | standard # " " " " " " -inclpath ignoresys | # treat <...> includes exactly like "..." includes ignoresystem |# " " " " " " " nosys | # " " " " " " " nosystem # " " " " " " " -includes mac | # controls how to interpret #include pathnames (mac is default) dos | # convert DOS pathnames to Mac pathnames unix # convert Unix pathnames to Mac pathnames -inline all # functions are inlined wherever possible, regardless of cost -inline on # functions are inlined as defined in the C++ source (default) -inline none | off # inlining of C++ function expansions will be suppressed -inline 0 | 1 | 2 | 3 | # sets complexity limit on functions to be inlined. 4 | 5 # -ir pathname[,…] # recursively search for include files in directory specified by pathname -j0 # accept two byte sequences for Japanese -j1 # accept two byte sequences for Taiwanese or Chinese -j2 # accept two byte sequences for Korean -l filename # generates a listing to the specified file (need -e for macro expansions) -ldsize 64 | 128 # determines the size of long doubles (default = 64) -load[c] filename # restore the state of the compilation from the specified file -longlong off # disable support of long long types -longlong on # support long long types (default) -make filename # generate Make dependency rules into the specified file -noMapCR # changes the default mapping of \n to 0x0A and \r to 0x0D -notOnce # allow multiple copies of header files -o filename | dirname: # specify output filename or directory -opt off # suppress all optimizations (default with -sym on) -opt local # perform local optimizations (default with -sym off) -opt size # optimize for size [,warn_uninit] # warn about variables which are definitly used before being set [,warn_maybe_uninit] # warn about variables which may used before set [,ok_to_reduce_opt] # warn about reducing optimization level due to low memory -opt speed # optimize for speed [,unroll] # as above, plus loop unrolling [,unswitch] # as above, apply loop unswitching [,norep] # as above, but do not repeatedly apply global copy propagation # and redundant store elimination [,nointer] # as above, but no interprocedural optimizations [,warn_uninit] # warn about variables which are definitly used before being set [,warn_maybe_uninit] # warn about variables which may used before set [,ok_to_reduce_opt] # warn about reducing optimization level due to low memory -p # output progress information to the standard error file -poolstringsbyfunc # string constants are associated with their functions instead of compilation unit -prefix pathname # #include the specified file(s) prior to reading the first source file. [,pathname…] # -rtti on | off # enable/disable run-time type information (RTTI, default on) -shared_lib_export on # create a shared library and create file that contains entry point list -shared_lib_export off # don't create shared library (default) -som # enable direct-to-SOM -sym off # disable generation of symbolic debugging information (default) -sym on | full # enable generation of symbolic debugging information [,nolines] # omit source line information [,notypes] # omit type information [,novars] # omit variable information [,alltypes] # generate type information for all types (including unreferenced types) -t # display compilation time -target ppc | powerpc # generate code for PowerPC architecture -target power # generate code for Power architecture -target 601 # generate code for PowerPC 601 -target 603 # generate code for PowerPC 603 -target 604 # generate code for PowerPC 604 -tb on # generate IBM RS/6000 traceback tables (same as -traceback) -tb pragma # generate IBM RS/6000 traceback tables only for #pragma traceback functions -tb exp[ort] # generate IBM RS/6000 traceback tables only for #pragma export functions -tb outofline # generate IBM RS/6000 traceback tables only for #pragma outofline functions -traceback # generate IBM RS/6000 traceback tables -u all # #undef all predefined non-ANSI macros -u name[,…] # #undef name, where name is a predefined non-ANSI macro name -unique_strings # force all string constants to be unique -vec[tor] off # do not accept vector functions and types (default) -vec[tor] on # accept vector functions and types [,vrsave | # maintain VRsave in prologs and epilogs (default if -vector on) ,novrsave] # do not maintain VRsave in prologs and epilogs -w off # suppress all warnings -w [is]err[or] # treat warnings as errors -w n1[,n2…] # suppress the specified warning messages -x # continue past the normal maximum error limit (4) -xa public # template expansions have public scope (default) -xa static # template expansions have static scope -xa extern # templates are not expanded in the current compilation unit -xi spec # instantiate the specified template -y directory # write compiler temporary and object files to directory (default:same as source file) - MrPlus # Post-link analysis of a Macintosh PowerPC™ executable for code coverage or performance MrPlus [option…] PEFfile -instrument branches | # instrument all arcs calls | # instrument function calls only exports | # trace calls to exports (requires InstrumentationLib) imports | # trace calls to imports (requires InstrumentationLib) loads | # detect attempts to load from low memory (0-32K) stores | # detect attempts to store in low memory (0-32K) none # do not instrument any code | -monitor icache | # enable hardware counters to display instruction and cache # miss (604 only) counts none # disable hardware counters | -arrange routines | # rearrange routines relative to each other to improve instruction # caching and reduce the number of page faults. Requires pmap # and dynamic count input files blocks | # same as preceding option with unexecuted blocks of routines # placed at end of code section none # do not arrange any code | -opt static[,size] | # do static optimizations such as removing superfluous NOPs # after local function calls and sharing non-trivial epilog # code from multiple return routines dynamic[,size] | # same as preceding option with additional branching # optimizations based on dynamic data; # requires pmap and dynamic count input files none # do not optimize any code -arrout arrfile # specify name of "link order" text file produced by # -arrange modes; default is "PEFfile.arr". -cntin PCNTfile # specify name of input count file (-arrange or -opt dynamic # modes); default is "PEFfile.pcnt". Fragment terminates (-instrument # call/branches modes); default is "PEFfile.pcnt" -exclude INEXfile # specify name of input text file listing functions to exclude # when instrumenting for # imports or exports; default is to exclude no functions | -include INEXfile # specify name of input text file listing functions to # instrument for imports or exports; # default is to include all functions -fragout outPEFfile # specify name of output PEF file; default names are # "PEFfile.prof" for -instrument modes, # "PEFfile.mon" for -monitor mode, "PEFfile.opt" for -opt modes -mapin PMAPfile # specify name of input pmap file (-arrange or -opt dynamic modes); # default is "PEFfile.pmap" -mapout PMAPfile # specify name of output pmap file that encodes mapping of the # software counters (-instrument # call/branches modes); default is "PEFfile.pmap" in the same # directory as "PEFfile" -member name # specify name of specific fragment to be processed within a # multi-fragment PEFfile -progress # write to stderr additional details about progress in # processing the PEFfile -report glue # report occurrences of linker-generated glue routines that # enable cross-TOC calls -report imix # report the static or dynamic occurrence count of classes # of instructions; dynamic counts are reported only if # the -opt dynamic or -arrange options are used -report regs # report static register usages. -report unwind # indicate how many functions save LR, CR, General Registers, # and/or FPRs -report web # indicate for code flow entering PEFfile which imports could # possibly be invoked -xcin XCOFFfile # specify name of optional input XCOFF file; default # is "PEFfile.xcoff" -xcout XCOFFfile # specify name of output XCOFF file; default is "outPEFfile.xcoff" # (see -fragout option above for default output PEF file # naming conventions) - MultiSearch # find multiple patterns in text files in a directory tree MultiSearch (-t target_dir | -j target_dir) (-f path | pattern…) [-q | -v] [-p] [-i | -s] [-rp | -rf] -t target_dir # the path to the base directory to be recursively # searched. -j target_dir # the path to the directory to be searched. Only # the specified directory will be searched. -f path # the path to a text file containing the patterns, # words, or phrases to search for. Patterns may # not be specified on the command line if this # option is used. The file should contain a space # or line separated list of patterns and string # literals. Note that normal MPW quoting and # pattern matching rules apply, for example: # # fred joe # /whoever≈/ # # contains three patterns, 'fred', 'joe', and # '/whoever≈/', while the following: # # 'fred joe' # /whoever≈/ # # contains two patterns, 'fred joe' and /whoever≈/ pattern… # is a list of one or more patterns or string # literals to search for. Patterns may not be # specified on the command line if the -f option # is used. -q # specifies that the report should contain just the # matched text. By default, MPW commands are # generated with the matched text appended as a # comment. The -q option may not be specified with # the -v option. -v # specifies that a verbose report should be generated. # The matched text is shown on one line and MPW # commands to locate it are given on a separate line. # The -v option may not be specified with the -q # option. -p # Print progress and copyright information. Included # in the progress report is information on which # files do not contain the search patterns -i # specifies that all matches are to be case- # insensitive. By default, case sensitivity is # determined by the value of the {CaseSensitive} # shell variable. This option may not be used with # -s. -s # specifies that all matches are to be case-sensitive. # By default, case sensitivity is determined by the # value of the {CaseSensitive} shell variable. This # option may not be used with -i. -rp # report will be grouped by patterns -rf # report will be grouped by file (default) - NameRevisions # define a symbolic name NameRevisions [-u User] [-project Project] [-public | -private | -b] [-r] [-comments] [[-only] | name [[-expand] [-s] | [-replace] [-dynamic] [names… | -a]] [-cs comment | -cf file]] -u user # name of current user -project project # name of project that contains the revisions -public # create a public name (the default) -private # create a private name -b # print both public and private names -r # recursively execute NameRevisions starting with current project -comments # print comments -only # only print the names, not the associated revisions -expand # evaluate names to revision level before printing -s # print a single name per line -replace # completely overwrite the previous definition of name -dynamic # evaluate names to revision level when using not defining -a # all the files in the project -cs comment # a short description of the name -cf file # the comment is contained in the file - New # open a new window New [-h] [name…] -h # open the window as hidden - Newer # compare modification dates of files Newer [option…] file… target > newer -c # compare creation dates -e # report names that have same (equal) mod date as target -q # don't quote file names with special characters - NewFolder # create a new folder NewFolder name… - NewKeyMap # create alternate keyboard editor assignments - NewProject # create a new project NewProject -w | -close | ([-u user] [-cs comment | -cf file] [-dbv databaseVersion] project) -cf file # the comment is contained in the file -close # close the New Project window -cs comment # a short description of the project -w # open the New Project window -u user # name of current user -dbv databaseversion # database version to create (2 or 3) - ObsoleteNameRevisions # mark a symbolic name obsolete ObsoleteNameRevisions [-u User] [-project Project] [-r] [names… | -a] -u user # name of current user -project project # name of project that contains the symbolic names -r # recursively obsolete names -a # all the symbolic names in the project - ObsoleteProjectorFile # make a Projector file inactive ObsoleteProjectorFile [option…] file… -p # write progress information to standard output -u User # name of current user -project Project # name of project that contains the files - Open # open file(s) in window(s) Open [[-n | -r] [-t] [-h] | [-s] | [-f]] [name…] -n # open new file (default name Untitled) -r # open file for read-only use -t # open file as the target window -h # open the window as hidden -s # open the window in the Finder containing the file -f # use the Finder to open the file - OrphanFiles # remove Projector information from a list of files OrphanFiles file… - Parameters # write parameters Parameters [parameter…] > parameters - Pascal # Pascal compiler Pascal [option…] [file…] < file ≥ progress -b # generate A5 references for procedure addresses -c # syntax check only, don't create object file -clean # erase all symbol table resources -d name=(TRUE|FALSE) # set compile time variable name -e file # write errors to file -forward # allow only explicit forward and external object declarations -h # suppress error messages regarding unsafe handles -i directory,… # search for includes in directory,… -k directory # create symbol table resource files in directory -m # allow greater than 32K globals by using 32 bit references -mbg ch8 # include v2.0 compatible MacsBug symbols -mbg full # include full (untruncated) symbols for MacsBug -mbg off # don't include symbols for MacsBug -mbg number # include MacsBug symbols truncated to length number -mc68020 # generate MC68020 code -mc68881 # generate MC68881 code for floating point operations -model farCode| # generate load-time relocatable 32-bit references for farData|far # code, data, or both -model nearCode| # generate 16-bit references for code, data, or both nearData|near # (the default) -n # generate separate global data modules for better allocation -noload # don't use or create any symbol table resources -o objname # generate code in file or directory objname -only name… # only generate code for named modules -opt off # don't apply code optimizations -opt on | full # choose level of code optimization (full is default); # can modify with [,nopeep] [,nostatic] -ov # generate code to test for overflow -p # write progress information to diagnostics -r # don't generate range checking code -rebuild # rebuild all symbol table resources -sym off # don't generate symbolic records -sym on | full # generate symbolic records; can modify with [,nolines] [,notypes] [,novars] -t # write compilation time to diagnostics -u # initialize all data to $7267 for debugging use -y directory # create temporary files in directory - PasMat # Pascal programs formatter PasMat [option…] [input [output]] < input > output ≥ progress -a # set a- disable CASE label bunching -b # set b+ enable IF bunching -body # set body+ to disable indenting procedure bodies -c # set c+ suppress Return before BEGIN -d # set d+ use {…} comment delimiters -e # set e+ capitalize identifiers -entab # replace multiple blanks with tabs -f # set f- disable formatting -g # set g+ group assignment and call statements -h # set h- disable FOR, WHILE, WITH bunching -i directory,… # search for includes in directory,… -in # set in+ process includes -k # set k+ indent statements between BEGIN and END -l # set l+ literally copy reserved words, identifiers -list file # write listings to file -n # set n+ group formal parameters -o width # set output line width (default 80) -p # write progress information to diagnostics -pattern -old-new- # modify include names, changing old to new -q # set q+ no special ELSE IF formatting -r # set r+ upper case reserved words -rec # set rec+ to indent field lists under defined id -s file # substitute identifiers based on pairs in file -t tab # set output tab setting (default 2) -u # rename identifiers to match first occurence -v # set v+ put THEN on separate line -w # set w+ upper case identifiers -x # set x+ suppress space around operators -y # set y+ suppress space around := -z # set z+ suppress space after commas -: # set :+ align colons in VAR declarations -@ # set @+ multiple CASE tags on separate lines -∂# # set #+ smart grouping of assignments and calls -_ # set _+ delete _ from identifiers - PasRef # Pascal cross-referencer PasRef [option…] [file…] < file > crossReference ≥ progress -a # process includes and units each time encountered -c # process includes and units only once -cond # process $SETC and $IFC, $ELSEC, $ENDC conditionals -d # process each file separately -d name=TRUE|FALSE # set $SETC variable name to TRUE or FALSE -i directory,… # search for includes in directory,… -l # write identifiers in lower case -mc68020 # source contains {$IFC OPTION(MC68020)} directives -mc68881 # source contains {$IFC OPTION(MC68881)} directives -n # don't process USES or includes -ni | -noi[ncludes] # don't process include files -nl | -nol[istings] # don't list the input -nolex # don't write lexical information -nt | -not[otal] # don't write total line count -nu | -nou[ses] # don't process USES declarations -o # source written using Object Pascal -p # write progress information to diagnostics -s # don't write include and USES filenames -t # cross reference by total line number -u # write identifiers in upper case -w width # set output line width (default 110) -x width # set maximum identifier width - Paste # replace selection with Clipboard contents Paste [-c count] selection [window] -c count # repeat the Paste count times - PerformReport # generate a performance report PerformReport [option…] > reportFile ≥ progress -a # list all procedures, in segment order # (default: produce only partial list, sorted by %) -l linkDataFile # read link map file (concatenated with ROM.list) -m measurementsFile # read performance measurements file # (default: "Perform.Out") -n NN # show the top NN procedures (default: 50) -p # write progress information to diagnostics - PlaySound # play a sound ('snd ') resource PlaySound [option…] [name…] -q # quiet - no error messages -f filename # specify name of file containing 'snd ' resource name… # resource name of 'snd ' resource to play. - PopTag # fetch top of FindTag stack PopTag - Position # display current line position Position [-l | -c] [window…] -l # only list the line number -c # only list the character offsets - PPCAsm # Assemble PowerPC 60x Assembly Language Code PPCAsm [option…] file… > listing ≥ progress -auxheader 1L | RE | RO # generate auxiliary XCOFF header with specified module type # 1L = single use # RE = reusable # RO = read only -blocksize n # set I/O buffer size to n*512 bytes -c[heck] # syntax check - don't create an XCOFF file -case on | off # control case sensitivity for labels (default: off) -d[efine] id[=value],… # define identifier(s) (default value: 1) -dialect type # specify the default translation (e.g. Power, PowerPC) -i directory,… # search for include files in specified directories -l # write listing to <stdout> -lo filename # write listing to specified file -o filename # output written to object file named <filename> -p # write progress information to stderr -sym on | off | man # control debug symbol generation (default: man) -typecheck strict|on|off# control typecheck warnings (default: on) -w off | n1,n2… # suppress all warnings or just the listed warnings - PPCLink # link a PowerPC application, tool, shared library or static library PPCLink [option…] file… ≥ progress -ac n # align code modules on n-byte (minimum) boundaries -ad n # align data modules on n-byte (minimum) boundaries -blocksize n # set I/O buffer size to n*512 bytes -c resType # set output file creator -codeorder source | reference | staticcall | segment | file=fileName # order how routines are written to the output file # source = same order as in input files # reference = A calls B & C, B calls D, then A,B,C,D # staticcall = A calls B & C, B calls D, then A,B,D,C # segment = order routines by segments (default) # file = order routines as specified in text file # Use of this option might improve the performance of the # linked application/shared library. -d # suppress warnings about duplicate symbol definitions -dead on | off # exclude unused code and data from the output file # default value depends on value of -xm flag as follows: # -xm executable -dead on # -xm sharedlibrary -dead on # -xm library -dead off -@export fileName # export symbols specified in text file, one symbol per line -export name[,name]… # export the specified symbols -exportglue on | off # generate glue for exported routines (default: on) -fragname name # set PEF container fragment name (default: name of output file) -init default | none | name # set initialization entry point # default entry point depends on value of -xm flag as follows: # -xm executable __init_app # -xm sharedlibrary __init_lib # -xm library no init entry point -initbefore name[,name]…# mark the specified import libraries as "init before" # note - this option takes fragment names not file names -librename old=new # rename import libraries # note - this option takes fragment names not file names -linkfaster on | off # space/time tradeoff (default: on for faster, uses more space) -m[ain] name # set main entry point (default: __start) -map fileName # write link map to specified file -[no]mf # [don't] use temporary memory (default: mf) -o fileName # set output file name (default: PPCLink.out) -outputformat default | pef | xcoff # set output format # default value depends on value of -xm flag as follows: # -xm executable -outputformat pef # -xm sharedlibrary -outputformat pef # -xm library -outputformat xcoff # executables and shared libraries can be "xcoff" or "pef" # static libraries can only be "xcoff" -p # write progress information to diagnostics -packdata on | off # compress the data section (default: on) -profile on | # enable collection of profiling/performance info at runtime off | # disable profiling (default) exclude=name[,name]… # exclude specified routines from profiling -rodatais data | code | constant # place read-only data in the specified section (default: data) -roistext on | off # place read-only data in the .text/code section (default: off) # The default is "off" because the .text/code section is # not write-protected at runtime. -sg newSeg=old[,old]… # merge old segments into newSeg -share context | global | protected # set the sharing mode for the data section # context = shared within a context (default) # global = shared across all contexts # protected = readable by all contexts, writeable by privileged contexts -sym on|off|big|nobig # include debug symbols (default: off) # use -sym big if -sym on runs out of memory -t resType # set output file type -term default | none | name # set termination entry point # default entry point depends on value of -xm flag as follows: # -xm executable __term_app # -xm sharedlibrary __term_lib # -xm library no termination entry point -tocdataref on | off # optimize runtime calculations of data addresses (default: on) # Edit instructions, converting "lzw" to "addi" # when the TOC entry being loaded is the address # of a variable within ±32k of the TOC anchor. # This optimization improves the performance of the # linked application/shared library by avoiding a # memory reference at runtime. -uf fileName # report unused code and data symbols to specified file -unmangle on | off # unmangle C++ symbols in link map and messages (default: on) -v # verbose progress (implies -p) -vercur n # set PEF container "current version" to n (default: 0) -verdef n # set PEF container "definition version" to n (default: 0) -verimp n # set PEF container "implementation version" to n (default: 0) -w[arn] # suppress warning messages -@weak fileName # mark imports specified in text file as "weak", one import per line -weak name[,name]… # mark the specified imports as "weak" -weaklib name[,name]… # mark the specified import libraries as "weak" # note - this option takes fragment names not file names -xm e[xecutable] | # generate an application or tool (default) l[ibrary] | # generate a static library s[haredlibrary] # generate a shared library - PPCProff # analyze a .pgh file and display the results PPCProff [option…] file… > output ≥ progress -cutoff n # ignore procedures whose hierarchical times # are less than n%. (default: 0.005) -[no]mf # [don't] use multifinder memory (default: nomf) -p # write progress information to diagnostics -procoffsets on | off # display call site offsets/linenumbers (default: on) -sortorder keyword[,keyword]… # define how profile information is displayed flat # sort routines by their flat times hier[archical] # sort routines by their hierarchical times (default) [calls]from # associate arcs with the called routine [calls]to # associate arcs with the calling routine (default) -unmangle on | off # unmangle C++ symbols (default: on) -v # use verbose progress (implies -p) -w[arn] # suppress warning messages -xcoff fileName # the name of the XCOFF file containing symbolics - Print # print text files Print [option…] file… < file ≥ progress -b # print a border around the text -b2 # alternate form of border -bm n[.n] # bottom margin in inches (default 0) -c[opies] n # print n copies -dialog # display standard print dialog -ff string # treat "string" at beginning of line as a formfeed -f[ont] name # print using specified font -from n # begin printing with page n -h # print headers (time, file, page) -hf[ont] name # print headers using specified font -hs[ize] n # print headers using specified font size -l[ines] n # print n lines per page -lm n[.n] # left margin in inches (default .2778) -ls n[.n] # line spacing (2 means double-space) -md # use modification date of file for time in header -n # print line numbers to left of text -nw [-]n # width of line numbers, - indicates zero padding -p # write progress information to diagnostics -page n # number pages beginning with n -ps filename # include PostScript file as background for each page -q quality # print quality (HIGH, STANDARD, DRAFT) -r # print pages in reverse order -rm n[.n] # right margin in inches (default 0) -s[ize] n # print using specified font size -t[abs] n # consider tabs to be n spaces -title title # include title in page headers -tm n[.n] # top margin in inches (default 0) -to n # stop printing after page n - PrintProff # analyze a .proff file and print the results PrintProff TargetProgramName [-h | -f] [-p] [-c] [> outputFile] -h # hierarchical sort (default) -f # flat sort -c # for each procedure, list callees -p # write progress information to diagnostics - ProcNames # display Pascal procedure and function names ProcNames [option…] [file…] < file ≥ progress -b # display line info for procedure body -c # process includes and units only once -cond # process $SETC and $IFC, $ELSEC, $ENDC conditionals -d # reset total line count to 1 on each new file -d name=TRUE|FALSE # set $SETC variable name to TRUE or FALSE -e # suppress page eject between each procedure listing -f # PasMat format compatibility mode -i pathname,… # search for includes or USES in directory,… -l n # process only to max nesting level n -m # generate MPW Mark commands for procedure and function declarations -mc68020 # source contains {$IFC OPTION(MC68020)} directives -mc68881 # source contains {$IFC OPTION(MC68881)} directives -n # suppress line number and level information -o # source file is an Object Pascal program -p # write progress information to diagnostics -u # process USES declarations - Project # set or write the current project Project [-q | projectName] > project -q # don't quote projects with special characters - ProjectInfo # display information about a Project ProjectInfo [-project project] [-log] [-comments] [-latest] [-f] [-r] [-s] [-only | -m] [-af author | -a author] [-df dates | -d dates] [-cf pattern | -c pattern] [-t pattern] [-n name] [-newer | -update] [file…] -a author # only list revisions created by author -af author # only list files created by author -c pattern # only list revisions whose comment contains pattern -cf pattern # only list files whose comment contains pattern -comments # list comments along with the rest of the information -d dates # only list revisions whose create date is within dates -df dates # only list files whose mod date is within dates -f # list file information -log # print project log -m # only list files/revisions that are checked out -newer # info on files that would be checked out using this option -only # only list project information -project project # name of project to get information on -r # recursively list subprojects -latest # only list info on the latest revision on the main trunk -s # short listing, names and revision names only -t pattern # only list revisions whose task contains pattern -n name # only list revisions that have name -update # info on files that would be checked out using this option Note: pattern is either a literal string or /regular expression/. Note: "dates" may take the following forms: date # on date <date # before but not including date ≤date # before and including date >date # after and not including date ≥date # after and including date date-date # between and including dates Note: A date is mm/dd/[yy]yy [[hh:mm[:ss]] [AM|PM]] ([yy]yy < 100 assumes 20th century, e.g. 19yy) Note: "name" may take the following forms: name # in name <name # before name ≤name # before and including name >name # after name ≥name # after and including name - Quit # quit MPW Quit [-y | -n | -c] -y # save all modified windows (avoids dialog) -n # do not save any modified windows (avoids dialog) -c # cancel if a window needs to be saved (avoids dialog) - Quote # echo parameters, quoting if needed Quote [-n] [parameter…] > parameters -n # don't write return following the parameters - Redo # reverse previous Undo series (if {AllowMultipleUndo} = 1) - Rename # rename files and directories Rename [-y | -n | -c] oldName newName -resolve # resolve leaf aliases in oldName -y # overwrite existing file (avoids dialog) -n # don't overwrite existing file (avoids dialog) -c # cancel if conflict occurs (avoids dialog) - RenameProjectorFile # give Projector file a new name RenameProjectorFile [option…] oldName newName -p # write progress information to standard output -u User # name of current user -project Project # name of project that contains the file - Replace # replace the selection Replace [-c count] selection replacement [window] -c count # repeat the replace count times - Request # request text from a dialog box Request [option…] [message…] < file -q # don't set status if user selects cancel -d default # set default response - ResEqual # compare the resources in two files ResEqual [option…] File1 File2 -attr # skip comparison of file attributes -fFlags # skip comparison of Finder flags -noResolve # do not resolve leaf aliases -only type # compare only resources of this type -p # write progress information to diagnostics -rFlags # skip comparison of resource attributes -skip type # skip comparison of resources of this type - ResolveAlias # resolve aliases in pathname ResolveAlias [option…] pathname > output -q # suppress quoting -v # include zone and server information in output - Revert # revert window to previous saved state Revert [-y] [window…] -y # revert to old version (without dialog) - Rez # resource compiler Rez [option…] [file…] < file ≥ progress -a[ppend] # merge resource into output resource file -align word | longword # align resource to word or longword boundaries -c[reator] creator # set output file creator -d[efine] name[=value] # equivalent to: #define macro [value] -i[nclude] pathname # path to search when looking for #include files -m[odification] # don't change the output file's modification date -noResolve # do not resolve any leaf aliases -noResolve include # do not resolve leaf aliases in include file # specifications -noResolve output # do not resolve leaf aliases in the output file # specification -o file # write output to file (default Rez.Out) -ov # ok to overwrite protected resources when appending -p # write progress information to diagnostics -rd # suppress warnings for redeclared types -ro # set the mapReadOnly flag in output -script language # specify the character set (see Note) -s[earch] pathname # path to search when looking for INCLUDE resources -t[ype] type # set output file type -u[ndef] name # equivalent to: #undef name Note: The following languages may be used with the -script option: Roman (default) Japanese Korean SimpChinese TradChinese - RezDet # detect inconsistencies in resources RezDet [option…] file… > dump -b[ig] # read resources one at a time, not all at once -d[ump] # write -show information, plus headers, lists, etc. -l[ist] # write list of resources with minimum information -noResolve # do not resolve leaf aliases -q[uiet] # don't write any output, just set {Status} -r[awdump] # write -dump information plus contents -s[how] # write information about each resource -t[erse] # suppress messages other than error messages Note: Use at most one of -quiet, -list, -show, -dump, and -rawdump. - RotatePanes # make another window pane the active pane RotatePanes [-r] [window] -r # reverse rotation; make previous pane active - RotateWindows # send active (frontmost) window to back RotateWindows [-r] -r # reverse rotation; bring bottom window to front - RProj # send Projector command to SourceServer RProj command - RShell # send a command to a "remote" shell RShell [ -status | -c id | -k id | [ -f | -b | -r target ] [ -q ] [ command ] ] -status # display information, including transaction id, # about pending RShell requests -c id # close the files associated with the request whose # transaction identifier is id -k id # abort the request whose transaction identifier is id -f # send the command to the foreground (MPW Shell) -b # send the command to the background (ToolServer) -r path # send the command to a remote application whose network # path is given by path -q # quit--if combined with a command, the command # is executed first command # the string to be sent to the target application Note: If none of the choices: command, -q, -k, -c, or -status are given, RShell will read from standard input. If none of -f, -b, or -r are given, RShell will display a browser for target selection. - Save # save specified windows Save [-a | window…] -a # save the contents of all windows - SaveOnClose # set save behavior when closing windows SaveOnClose [-a | -d | -n] [window…] -a # always save upon close ("Close -y") -d # default behavior for Close -n # never save upon close ("Close -n") - SC # Symantec C compiler SC [option…] [file] -align power # set alignment within structres | mac68k | byte -ansi off # ANSI compatability | on | relaxed | strict -auto_import size # if cfm model, flag data of 'size' bytes as imported -b # produce pc relative strings and functions -b2 # produce pc relative strings and functions, overlay equal strings -b3 # produce pc relative strings -bigseg # generate code for single large segment -char signed # default sign of chars | unsigned | unsignedX -d name # equivalent to: #define name 1 -d name=string # equivalent to: #define name string -dump[c] filename # save state of C compilation in filename -e # if -l is specified, show macro expansions in listing -elems881 # generate MC68881 code for transcendentals (for 68K only) -enum min | int # set enum size -frames # always generate stack frames -i[path][,path] # search for header files along path -ignorepragma id,… # ignore #pragmas with the specified #pragma id's -j0|1|2 # recognize 2 byte Japanese|Chinese, Taiwanese|Korean characters -l filename # generate a list file -load[c] filename # load saved C compilation state from filename -mbg on|full|off # on=full generate MacsBug symbols (default) -mc68020 # generate MC68020 code (for 68K only) -mc68030 # generate MC68030 code (for 68K only) -mc68040 # generate MC68040 code (for 68K only) -mc68881 # generate MC68881 code for arithmetic operations (for 68K only) -model farCode # generate load-time relocatable 32-bit references for code, | farData # data, | far # or both (for 68K only) -model nearCode # generate 16-bit references for code, | nearData # data, | near # or both (default) -model cfmseg # request generation of multi-segment CFM-68K runtime model supporting shared libraries -model cfmflat # request generation of single segment CFM-68K runtime model supporting shared libraries -nomfmem # inhibit use of MultiFinder memory -notOnce # allow multiple copies of header files -o filename|dirname: # set output file or directory -onefrag # assume any C++ constructs for CFM-68K runtime model are in the same fragment -opt all # use all optimizations except space | off # perform minimal optimizations | none # perform minimal optimizations | space # favor space optimizations over time optimizations | time # favor execution time optimizations over space optimizations | speed # favor execution time optimizations over space optimizations -p # print progress messages -paslinkage # Pascal linkage option -prefix pathname # #include the specified file(s) prior to reading the first source file. [,pathname…] # -proto strict | auto # strict prototyping -s[eg] segname # assign code to segment (for 68K only) -sym off # no symbolic records -sym on|full # full symbolic records [,notypes] # omit type information [,nolines] # omit source line information [,novars] # omit variable information [,alltypes] # include ALL type information -trace on # generate tracing code--calls to %_EP and %_BP -trace off # generate no tracing code (default) -trace always # always generate tracing code--calls to %_EP and %_BP -trace never # never generate tracing code (default) -typecheck strict # perform strict type checking (default). -typecheck relaxed # perform relaxed type checking -u # suppress predefined non-ANSI macros -w on # print all warnings (default) | off # don't print warnings | [is]err[or] # warnings are treated as errors | #[,#...] # don't print warning #N -x # continue past error limit - SCpp # Symantec C++ compiler SCpp [option…] [file] # -align power # set alignment within structres | mac68k | byte -ansi off # ANSI compatability | on | relaxed | strict -auto_import size # if cfm model, flag data of 'size' bytes as imported -b # produce pc relative strings and functions -b2 # produce pc relative strings and functions, overlay equal strings -b3 # produce pc relative strings -bigseg # generate code for single large segment -bool on # enable C++ 'bool', 'true', and 'false' as standard keywords -bool off # 'bool', 'true', 'false' are normal identifiers (default) -char signed # default sign of chars | unsigned | unsignedX -d name # equivalent to: #define name 1 -d name=string # equivalent to: #define name string -dump[c] filename # save state of C++ compilation in filename -e # if -l is specified, show macro expansions in listing -EH # enable exception handling (same as -exceptions on) -elems881 # generate MC68881 code for transcendentals (for 68K only) -enum min | int # set enum size -ER # enable run-time type identification (RTTI, same as -rtti on) -exceptions on | off # enable/disable exception handling (default off) -frames # always generate stack frames -i[path][,path] # search for header files along path -ignorepragma id,… # ignore #pragmas with the specified #pragma id's -inline all # functions are inlined wherever possible, regardless of cost -inline on # functions are inlined as defined in the C++ source (default) -inline none | off # inlining of C++ function expansions will be suppressed -ir pathname[,…] # recursively search for include files in directory specified by pathname -j0|1|2 # recognize 2 byte Japanese|Chinese, Taiwanese|Korean characters -l filename # generate a list file -load[c] filename # load saved C++ compilation state from filename -mbg on|full|off # on=full generate MacsBug symbols (default) -mc68020 # generate MC68020 code (for 68K only) -mc68030 # generate MC68030 code (for 68K only) -mc68040 # generate MC68040 code (for 68K only) -mc68881 # generate MC68881 code for arithmetic operations (for 68K only) -model farCode # generate load-time relocatable 32-bit references for code, | farData # data, | far # or both (for 68K only) -model nearCode # generate 16-bit references for code, | nearData # data, | near # or both (default) -model cfmseg # request generation of multi-segment CFM-68K runtime model supporting shared libraries -model cfmflat # request generation of single segment CFM-68K runtime model supporting shared libraries -nomfmem # inhibit use of MultiFinder memory -notonce # allow multiple copies of header files -o filename|dirname: # set output file or directory -onefrag # assume any C++ constructs for CFM-68K runtime model are in the same fragment -opt all # use all optimizations except space |off # perform minimal optimizations |none # perform minimal optimizations |space # favor space optimizations over time optimizations |time # favor execution time optimizations over space optimizations |speed # favor execution time optimizations over space optimizations -p # print progress messages -paslinkage # Pascal linkage option -prefix pathname # #include the specified file(s) prior to reading the first source file. [,pathname…] # -rtti on | off # enable/disable run-time type information (RTTI, default off) -s[eg] segname # assign code to segment (for 68K only) -som # enable direct-to-SOM -sym off # no symbolic records -sym on|full # full symbolic records [,notypes] # omit type information [,nolines] # omit source line information [,novars] # omit variable information [,alltypes] # include ALL type information -trace on # generate tracing code--calls to %_EP and %_BP -trace off # generate no tracing code (default) -trace always # always generate tracing code--calls to %_EP and %_BP -trace never # never generate tracing code (default) -u # suppress predefined non-ANSI macros -w on # print all warnings (default) | off # don't print warnings | [is]err[or] # warnings are treated as errors | #[,#...] # don't print warning #N -x # continue past error limit -xa templatespec # instantiate a template with arguments -xi p[ublic] # instantiate templates in this file with public access | s[tatic] # expanded templates in this file have static scope | e[xtern] # templates are accessed externally and are assumed expanded in another file - SCpre # Pre-process C/C++ source generating input to a Symantec compiler SCpre [option…] [file] # -c # Pre-process as a C compilation rather than C++ -d name # equivalent to: #define name 1 -d name=string # equivalent to: #define name string -i[path][,path] # search for header files along path -j0|1|2 # Recognizing Multi-byte Asian Character -nomfmem # Inhibit Use of Multi-finder Memory -notonce # allow multiple copies of header files -o filename|dirname: # set output file or directory -p # print progress messages -u # suppress predefined non-ANSI macros - Search # search files for pattern Search pattern [file…] [option…] < file > found -b # break "File/Line" from matched pattern -e pattern # search for pattern (allows pattern to be specified last) -exclude file|directory # skip the specified file (or directory if -rd specified) -f file # lines not written to output are put in this file -fb # flush the output buffer after every match -i # case insensitive search (overriding {CaseSensitive}) -nf # write error message if pattern not found -ns # return status code of 0 if pattern not found -p # write progress information to diagnostic output -pv # verbose progress information -q # suppress file name and line number in output -r # write non-matching lines to standard output -rd # recursive search -s # case sensitive search (overriding {CaseSensitive}) -sf # stop at first match -skipAlias # skip aliases -t type # only search files with specified file type -w # suppress warning messages -word # search for whole words only - SendAE # Send Apple Event to application SendAE [option…] [Apple Event Parameters…] -do # only output the direct object -dot # same as -do, output as text -e classAndID # 8 characters to denote event class and id -hiprio # high priority message, default is AENormalPriority -m sendMode # default: kAEWaitReply -rid returnID # default: kAutoGenerateReturnID -t [zone:server:]target # target application, default: "{AETargetID}" -tid transactionID # default: kAnyTransactionID -timeout ticks # time out in ticks, default: kAEDefaultTimeout -u userName # default user name from Sharing Setup panel Apple Event Parameters: -xxxx data # parameter in AEBuild format, xxxx is the keyword -xxxxyyyy data # parameter in yyyy format, xxxx is the keyword -@xxxx data # attribute in AEBuild format, xxxx is the keyword -@xxxxyyyy data # attribute in yyyy format, xxxx is the keyword yyyy=file: data is a filename; read the data from that file yyyy=alis: data is a filename list; the data becomes a list of aliases to those files - Set # define or write Shell variables Set [-e] [name [value]] > variableList -e # export the variable after setting it - SetDirectory # set the default directory SetDirectory directory - SetFile # set file/folder attributes SetFile [option…] file/folder… -a attributes # attributes (lowercase = 0, uppercase = 1)* -c creator # file creator -comments text # put "text" in the "Get Info" comments field -d date # creation date (mm/dd/[yy]yy [hh:mm[:ss] [AM | PM]])* -l h,v # ICON location (horizontal,vertical)* -label label # set Finder label value; label can be 0-7 or label name -m date # modification date (mm/dd/[yy]yy [hh:mm[:ss] [AM | PM]])* -noResolve # don't resolve aliases on the input file path -t type # file type Note: Period (.) represents the current date and time. Note: [yy]yy < 100 assumes 20th century, e.g. 19yy Note: date is specified using currently selected format in Date & Time Control Panel, or MPW uniform format (yyyy◊mm◊dd hh:mm:ss). See help for "Date" Note: The following attributes may be used with the -a option: A Alias file V Invisible* B Bundle S System (name locked) T Stationary C Custom icon* L Locked I Inited* N No INIT resources M Shared (can run multiple times) W Always switch launch (if possible) D Desktop* Note: Options/attributes marked with an asterisk (*) are allowed with folders - SetKey # define or write key bindings SetKey <empty> | -r | [modifierkey-]…key[-modifierkey-]…key] [string] modifierkey = command | option | shift | control -r # revert to the default key assignments - SetPrivilege # set access privileges for directories on file servers SetPrivilege [option…] directory… > information -d privileges # set privileges for seeing directories -f privileges # set privileges for seeing files -g group # make the directories belong to group -i # return information on directories -m privileges # set privileges for making changes -o owner # make owner the owner of directories -r # operate (set or list) recursively Note: The following privilege characters may be used with the -d, -f, or -m options (Upper case enables the privilege, lower case disables it): O Owner G Group E Everyone - SetShellSize # set the shell's stack and Process Manager partition sizes SetShellSize [option…] -f ShellFileName # specify pathname of MPW Shell to modify # if omitted, sets sizes of currently executing shell -s StackSize[k] # set stack size in bytes or (with 'k' suffix) kilobytes -p PartitionSize[k] # set partition size in bytes or (with 'k' suffix) kilobytes If neither -p or -s options are supplied, the tool displays the current settings. - SetVersion # maintain version and revision number SetVersion [option…] file > output ≥ progress -b # increment the bug fix component by 1 -country name # country code name -csource file # update the #define Version string in C source -d # display (updated) version numbers to standard output -fmt nƒ.mƒ # format version numbers according to specification -i resid # use specified resource id instead of 0 -noResolve # do not resolve leaf aliases in "file" -p # write SetVersion's version info to diagnostic file -prefix prefix # prefix version with specified prefix -[p]source file # update the Version string constant in Pascal source -r # increment the revision component by 1 -rezsource file # update the resource definition in Rez source -sb bugfix # set the bug fix component to the specified value -sr revision # set the revision component to the specified value -stage stage # set release stage for a 'vers' resource -suffix suffix # suffix the version with specified suffix -sv version # set the version component to the specified value -sx nonrel # set the non-release component to the specified value -sync 1 | 2 # synchronize 'vers',1 with 'vers',2 or vice versa -t type # use specified resource type -v # increment the version component by 1 -verid identifier # use C/Pascal source version id instead of "Version" -version fmtstring # alternate way of specifying version component actions -verstring longstring # set the long version string of a Finder 'vers' resource -x # increment the non-release component by 1 - Shift # renumber command file positional parameters Shift [number] - shlb2stub # create a stub ('stub') library from a shared ('shlb') library shlb2stub [option…] shlbFile ≥ progress -o fileName # set output file name (default: <shlbFile>.stub) -p # write progress information to diagnostics - ShowSelection # place the selection within an editor window ShowSelection [-t | -b | -c | -n lines | -l line] [window] -t # place first line of selection at top of window -b # place first line of selection at bottom of window -c # center the first line within the window -n lines # place first line of selection lines from the top -l line # place line at the top of window - ShowWindows # make previous hidden windows visible ShowWindows window… - Shutdown # power down or restart the machine Shutdown [-y | -n | -c] [-r] -y # save all modified windows (avoids dialog) -n # do not save any modified windows (avoids dialog) -c # cancel if a window needs to be saved (avoids dialog) -r # restart the machine - SizeWindow # set a window's size SizeWindow [h v] [window] h # window width (horizontal) v # window height (vertical) - SOMC # SOM idl compiler SOMC [option…] sources.idl… ≥ progress -D define # defines macro for #ifdef processing -D define=value # defines macro with a value -e namelist # runs backend emitters in comma separated name list # emitters for C are c,h,ih,exp # emitters for C++ are xc,xh,xih,exp -keeptm # keeps temporary intermediate files -I folder # search for .idl include files in "folder" -m name # turns option "name" on -m chkexcept # specifies the inclusion of exception result # checking during generation of C++ .xh class # bindings. This mechanism can be used to introduce an # automatic “throw” or error handler of some sort, # removing the need to manually check exc -m cplusc # use .C for C++ file suffix -m cpluscpp # use .cpp for C++ file suffix -m notexported # turns CFM68K pragma generation off -o outdir # specifies the output directory for emitted files. # (note that this does not specify the output file itself.) -other option # passes "option" thru to the back end -p # keep private info (sets macro __PRIVATE__ to 1) -r # checks for undefined names in the release order statement -v # uses verbose mode -w # turns warnings off - SOMpdl # sanitize .idl file(s) for public consuption SOMpdl [option…] sources.idl… -d folder # specifies folder for output files - Sort # sort or merge lines of text Sort [option…] [files…] -b # skip leading blanks of each field -check # check if input is sorted (exit code 5 if not). -d # sort fields as decimal numbers -f field[,field] # specify fields to sort on (see below) -fs string # specify field separator characters -l # convert to lowercase before comparison -merge # merge pre-sorted input files -o file # specify output file, allows sorting-in-place -p # print version and progress information -quote # handle fields with quotes -stdin # place-holder for standard input (acts like a file) -r # reverse order of comparison -t # sort fields as text (default) -u # convert to uppercase before comparison -unique # write only unique output lines -x # sort fields as hexadecimal numbers (leading '$' # or '0x' is ignored) The comma-separated field specifications (following -f) take the forms: [F][.C][-K][bdlqrtux] or [F][.C][+N][bdlqrtux] 'F' is a field number (0=whole line [default], 1=first word, 2=second word…). 'C' is the starting column number (from 1), default=1. 'K' is the ending column number >= C, default=infinite. 'N' is the maximum number of characters in the field, default=infinite. Only one of '-K' or '+N' can be specified. The local modifier characters 'bdlqrtux' have the same meaning on a per-field basis as -b, -d, -l, -q, -r, -t, -u and -x (which take effect globally). - StackWindows # arrange windows diagonally StackWindows [-h num] [-v num] [-r top,left,bottom,right] [-i | windows…] -h num # horizontal offset between windows -v num # vertical offset between windows -r t,l,b,r # rectangle in which to stack windows -i # include the worksheet windows… # list of windows to tile - StreamEdit # scriptable text editor StreamEdit [option…] file… -d # delete lines (don't copy them) -e statements # add 'statements' to the script -o file # direct output to file in a "safe" manner -p # print progress information -s file # specify a file containing a script to execute -set variable[=string] # set the value of a variable A script consists of zero or more of: <address> <command> or <address> -c count <command> The second form specifies that only the first "count" matches will be edited. Addresses take the forms (highest to lowest precedence): ( address ) # override precedence ! address # match line not matching the address address1 && address2 # match line matching address1 AND address2 address1 || address2 # match line matching address1 OR address2 address1 , address2 # match address1…address2 /regular expression/ # a line that matches the expression • # matches BEFORE the first line N # matches the Nth line $ # matches the last line ∞ # matches AFTER the last line A regular expression starting with 'ç' is case-sensitive. Any '•' must follow the 'ç'. Commands are: Append <text> # append text to append buffer Exit [status] # exit with zero or specified status Change <text> # set contents of edit buffer Delete # clear contents of edit buffer Insert <text> # append text to insert buffer Next # proceed with next line Print <text> # Print the text [-To file ] # directed to the specified file [-AppendTo file] # appended to the specified file Replace /pat/ <text> # do replacement [-c count] # specify repeat count (N or ∞) Set variable <text> # set variable's value [-a] # append to variable's current value [-i] # insert at front of variable's current value Option AutoDelete # append "1,$ Delete" to script Where <text> consists of zero or more of: "a string" # the specified text 'a string' # the specified text . # the current line (the edit buffer) variableName # the contents of the named string variable ®N # an "®" variable set by a regular expression -from <filename> # the next line from the file, where filename # is a string or a variable name -n # suppress newline at end If <text> is empty, it defaults to "." (the current line). - Target # make a window the target window Target [-h] name -h # open the window as hidden - TickCount # returns current system Tick Count TickCount > output - TileWindows # arrange windows in a tiled fashion TileWindows [-h | -v] [-r top,left,bottom,right] [-i | windows…] -h # tile windows horizontally -v # tile windows vertically -r t,l,b,r # rectangle in which to tile windows -i # include the worksheet windows… # list of windows to tile - TransferCkid # move Projector information from one file to another TransferCkid sourceFile destinationFile - Translate # translate characters Translate [option…] src [dst] < file > output ≥ progress -p # write progress information to diagnostics -s # set font, font size, and tab setting of output - Unalias # remove aliases Unalias [name…] - Undo # undo the last edit (or edits if {AllowMultipleUndo} = 1) Undo [window] - Unexport # remove variable definitions from the export list Unexport [-r | -s | name…] > unexports -r # generate Export commands for all unexported variables -s # print the names only - UnlockNameRevisions # unlock a symbolic name UnlockNameRevisions [-u User] [-project Project] [-password password] [-r] [names… | -a] -u user # name of current user -project project # name of project that contains the symbolic names -password password # the password for this lock -r # recursively unlock names -a # all the symbolic names in the project - Unmangle # unmangle mangled C++ names Unmangle [option…] [signature…] -a[ctive] # use the current selection in the active window -h[elp] # display this help info -t[arget] # use the current selection in the target window -v[erbose] # duplicate the output of the old UnmangleTool command Note: Unmangle reads from stdin (one signature per line) if signatures are not supplied in the argument list or via -a or -t. - Unmark # remove a marker from a window Unmark name… window - Unmount # unmount volumes Unmount volume… - UnmountProject # unmount projects UnmountProject -a | Project… -a # unmount all mounted projects - UnobsoleteNameRevisions # mark a symbolic name not obsolete UnobsoleteNameRevisions [-u User] [-project Project] [-r] [names… | -a] -u user # name of current user -project project # name of project that contains the symbolic names -r # recursively unobsolete names -a # all the symbolic names in the project - UnObsoleteProjectorFile # make an inactive Projector file active again UnObsoleteProjectorFile [option…] file… -p # write progress information to standard output -u User # name of current user -project Project # name of project that contains the files - Unset # remove Shell variable definitions Unset [name…] - UnsetKey #remove key bindings UnsetKey [modifierkey-]…key[-modifierkey-]…key] modifierkey = command | option | shift | control - UpdateProjectorDatabase # update Projector database to latest version UpdateProjectorDatabase [option…] project -p # write progress information to standard output -r # recursively update Projector databases -y # answer yes to all dialogs (avoids dialogs) - UserVariables # uses Commando to set all the user variables UserVariables - Version # print the version of the MPW Shell Version -v # produce verbose output - VersionList # print version info from files VersionList [option…] [file…] > versionsReport -all # print version info for all files in directory -c creator # report on files that have the named file creator. # Default is 'MPS ' -d # include modification date in report -h # suppress the report header and footer -l # don't truncate very long file names -newer date # report on files whose modification date is # newer than date -noResolve # do not resolve file aliases -older date # report on files whose modification date is # older than date -p # write progress information to diagnostic output -r # recursively search subdirectories -raw # suppress all formatting. Print tab-delimited columns -t type # report on files that have the named file type. # Default is 'MPST' -u path # start search at <path>. Default is {MPW}Tools: -v # include 'vers' 2 resource info in report - Volumes # list mounted volumes Volumes [option…] [volume…] > volumeList -l # long format (name, drive, size, free, files, dirs) -q # don't quote volume names with special characters -local # list only local volumes -server # list only server volumes - WhereIs # find the location of a file WhereIs [option…] pattern… -c # completely match filepattern -d # include directories -resolve # if file is an alias, resolve and show path to target -v # verbose output - put summary line at end -x # don't use PBCatSearch system call (sometimes slower) -s directory # starting directory/volume for search - Which # determine which file the shell will execute Which [option…] [name] > file ≥ progress -a # report all commands named "name" -p # writes progress information to diagnostics - Windows # list windows Windows [option…] -q # don't quote window names with special characters -o # list "Open" command lines for execution -h # list only hidden windows -v # list only visible windows -clean # list only "clean" windows -dirty # list only "dirty" windows -e # exclude the Worksheet window - ZoomWindow # enlarge or reduce a window's size ZoomWindow [-b | -s] [window] -b # zoom to full screen (big) -s # zoom back to regular size (small)